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PREFACE 


This manual describes the extensions for use with the BASIC/RT-11, 
BASIC/PTS-11, and BASIC/CAPS-11 systems. The extensions enable you to 
utilize PDP-11 lab peripherals such as LPS11, AR11, and ODR11-K. 
Unless stated otherwise, the descriptions of all routines in this 
manual apply to the systems mentioned above. 


The routines for these peripherals are provided in library form that 
can be linked with a user program. The user should have a programming 
knowledge of BASIC and some understanding of the peripherals. 


The following table describes the documentation conventions used in 
this manual. 


Convention Meaning 
<LF> Line feed 
<CR> Carriage return 
or CTRL Used with special system control 


characters. Depress CTRL key while 
striking designated character. 


(S) Altmode 
Square Brackets [ ] Optional arguments are enclosed. 
Lower caSe letter or Value to be supplied by user. May 
lower case letter be any valid arithmetic expression. 


followed by a digit 
(a,b,x0,yl1) 


Lower case letter String to be supplied by user. May 

followed by a dollar be string constant (enclosed in 

Sign (a$,x$) quotes) or variable (A$). 

Upper case letter Numeric variable whose value will 

(A,B,X,Y) be determined by call or an array 
name. 

Y axis The vertical axis. 

X axis The horizontal axis. 


The following manuals are necessary references for this manual: 


RT-11 System Reference Manual 
DEC-11-ORUGA-C-D 


BASIC-11 Language Reference Manual 
DEC-11-LIBBA-B-D 


BASIC/RT-11 Language Reference Manual 
DEC-11-LBACA-D-D 


BASIC/PTS User's Manual 
DEC-11-LPTBA-A-D 


BASIC/CAPS-11 User's Manual 
DEC-11-LIBCA-A-D 


LPS11 User's Guide 
DEC~11-—-HLPGA-C-D 


AR11 User's Guide 
DEC-11-HARUG 


DR11-K Interface User's Guide and Maintenance Manual 
EK-DRL1K-MM-001 
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CHAPTER 1 


INTRODUCTION 


BASIC Extensions Support the RT-11, CAPS-11, and PTS-1l systems, and 
the following hardware: 


LPS11 Laboratory Peripheral System 
AR11 Analog Real-Time:Interface 
DR11-K Digital Input/Output Interface 


The Laboratory Peripheral System (LPS) support can utilize LPS11, AR11 
and DR11-K to sample and display data from analog to digital 
converters, digital input/output, or external events. LPS support 
contains 23 routines to control LPS11, AR11 and DR11-K. These 23 
routines are divided into five categories according to their function. 
Each category iS supplied as a module. The first module, LPSO, is the 
main module which contains all necessary support routines for using 
the other four modules. This module is required but the other four 
are optional. 


The support for the peripherals consists of a library of routines that 
can be controlled by a user program through a CALL statement. The 
format of the CALL statement is: 


CALL "name"(argument list) 


Under BASIC/CAPS-11, the routines can also be called by a statement of 
the form: 


name(argument list) 


The function and limitation of each routine is described in detail in 
the following chapter. 


™. 


CHAPTER 2 


LABORATORY PERIPHERAL SYSTEM SUPPORT 
(LPS11, AR11, DR11-K) 


2.1 GENERAL FEATURES 


Laboratory Peripheral System support for BASIC-ll allows a user to 
utilize the LPS hardware which includes LPS11, AR11 and up to 16 
DR11-K. LPS support enables the sampling and displaying in a 
real-time environment of a variety of data from analog to digital 
converters, digital input/output, and external events. Sampling is 
controlled by crystal clocks and/or Schmitt triggers; it is possible 
to specify such parameters aS sampling rate and response time thus 
allowing maximum flexibility. 


NOTE 


In a multiple DR11-K system, there must 
be a difference of 10(octal) between 
each unit in the interrupt and vector 
address. The status register address 
decreases by 10(octal) while the vector 
address increases by 10(octal). 


All LPS routines are issued by the BASIC CALL statement allowing 
experienced PDP~1l assembly language programmers to easily include or 
modify the routines to meet particular (or special) requirements. 


2.2 DESCRIPTION OF ROUTINES 


The BASIC Extensions contain 23 routines to control the following 
options on the LPS11 hardware: 


LPSAD-12 12-bit ADC, sample and hold, 8-channel 
multiplexer, and LED (light emitting diodes) 
6-digit programmable decimal readout display. 

LPSAD-NP Direct memory access (DMA) option for the LPSAL~12 


ADC. 

LPSAG Four differential preamplifiers with +or-1V input. 
Maximum of 4 LPSAGsS per LPS11-S system. 

LPSAG-VG Four independently selectable multigain 
differential preamplifiers. 

LPSAM 8-channel expansion multiplexer. 

LPSSA Second sample and hold for a dual sample and _ hold 
configuration. 

LPSKW Programmable real-time clock and _ two Schmitt 
triggers. 

LPSVC Display control including two 12-bit DACS. This 


2a 


LPSDR 
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controller is capable of handling Digital's VR14 
and VR20 scopes. 

16-bit buffered digital I/O with drive 
capabilities and two programmable normally open 
(n.o.) relays. LPSDR cannot be used if DR11-K is 
used. 


The 23 routines are divided into 5 categories according to 
function. Each category is supplied as a Separate module. 


The following 


list is a summary of the routines available 


controlling LPS hardware and a brief description of each: 


MODULE LPSO (This module is always required.) 


USE 


ACC 
RDB 


Defines array(s) to be used for storage of 
data. 

Allows access to an entire array. 

Returns the next data point from a specified 
buffer. 


MODULE LPS1 (ANALOG TO DIGITAL CONVERSION) 


ADC 


RTS 


LED 


CVSG 


Initiates an A/D conversion on a_e specified 
channel and returns the result to the user. 
Performs real-time buffered/clocked sampling 
of the A/D. 

Displays a numeric value on the Light 
Emitting Diodes. 

Returns the next data value and gain in two 
separate variables. 


MODULE LPS2 (REAL-TIME CLOCK) 


SETR 


SETC 


HIST 


WAIT 
RTIM 


Sets clock running at a designated rate and 


mode. 
Sets clock running at a designated rate and 
initiates some action after a specified 


number of seconds have elapsed. 

Performs histogram sampling using a_ timed 
Schmitt trigger. 

Waits for a specified event to occur. 

Returns the value of the internal software 
clock counter. 


MODULE LPS3 (DIGITAL I/0) 


DIR 
DOR 
DRS 


REL 
IPK 


Reads Digital Input register. 

Writes Digital Output register. 

Performs sampling of the Digital Input 
register. 

Closes or opens one of two relays. 

Reads a value from a register or writes a 
value into a register. 


MODULE LPS4 (DISPLAY) 


CLRD 


PUTD 


Defines display buffer and optionally clear 
or scale the data in it. 
Puts data into data buffer. 


their 


for 
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DIS Displays data with incrementing x and 
variable y whenever BASIC is waiting for I/O. 

FSH Displays a Single complete sweep of data with 
incrementing x and variable y. 

DXY Displays data with variable x and y values 
whenever BASIC is waiting for I/O. 

FXY Displays a single complete sweep of data with 


variable x and y values. 


Module LPSO is the main module and contains not only the USE, ACC, and 
RDB routines, but also all necessary support routines for the other 


modules. Therefore, it must be included, although the other modules 
are optional. 


Data buffers used by the LPS routines differ from the normal arrays in 
BASIC in that they use only one word of storage per data element 
rather than two. This is because all LPS data is no larger’ than 
2**16-1 and can be stored as unsigned 16-bit data. All data buffers 
must be defined by a USE routine before they are accessed by any other 
LPS routines. The USE routine allows the user to partition and make 
equivalent arrays for ease in displaying and manipulating common data. 
All data buffers defined in the USE routine are circular with internal 
pointers keeping track of where data is to be placed next and/or 
retrieved. 


2.3 MODULE LPSO (REQUIRED MODULE) 


2.3.1 Defining the Buffer (USE) 


The USE routine defines buffer areas for use with the ACC, RDB, RTS, 
HIST, DRS, CLRD, PUTD, DIS, FSH, DXY and FXY routines. This routine 
sets up internal pointers allowing circular buffering and data overrun 


and/or nonexistent data checking. A maximum of five buffers may be 
specified, all of which must be given in a single USE statement. All 
areas defined in the USE statement must have been previously 


dimensioned in a DIM statement. 
The format of the USE call is: 
CALL. “USE (AL(I).1 91 BEC paw oy ChE) 4 


where 


A,B,C are the names of previously dimensioned array(s). 
May be 5 different arrays or array names may be 
repeated. 

Loi cepresents a valid subscript for the array or 0 
which indicates the entire array. 


The USE routine defines buffer areas required for storage of data. 
These areas may be a partitioned array which can be made equivalent to 
one large array. The following examples illustrate all aspects of the 
USE routine. Note that the size of an area defined in a DIM statement 
is one half that desired. This is because BASIC uses two words’ to 
store data whereas the LPS data is stored in one word. 
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Example: 


Define areas A, B, and C to have 100, 200, and 300 data points 
respectively. 


LO DIM ACHO ey BCLOOs oO C1) 
2O CALL “USE " (fie byl) 


Example: 


Define area A to consist of three parts, the first having 10 data 
points and the second and third having 20 each. Then define a final 
area having access to all of the array A (including the zero subscript 
element). 


NOTE 


Read the USE statement from left to 
right establishing the separate areas 
based on previously defined members of 
the same array. Only when the starting 
address of the next array is less’ than 
the previous one will entire access to 
the array be allowed by the following 
array. 


The subscripts in the declaration are used to define pseudo partition 
names which can be used in other LPS statements which require arrays. 


LO DEM ACR 4 
20 (TALL "USE" CACTI ACT TL yACS1d AD 


In this example, each declaration of the array A has a_ unique 
description. A, which is equivalent to A(0), is different than A(l), 
A(1l1), and A(31). The following figure illustrates the partitioning 
of the array A due to the preceding example. 


A(1) ( 
A(0) OR A 
A(11) 
A(31) ( 
In the example, the partitioning occurs as follows: A(1l) defines a 


buffer array starting at position A(1) in the array A and ending at 
the last position in the array. Since A(1ll) is declared immediately 
following it, the end of the array for A(1l) is redefined to be one 
less than the A(1l) position. At this point, A(1l) goes from the Ist 
position in the array to the 10th, and A(1l1) goes from the llth 
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position in the array to the 50th. When A(3l1) is declared immediately 
following A(1l), A(11) is redefined to go from the llth position in 
the array to the 30th and A(31) goes from the 31st position to the 
50th. Now the partitioned array consists of three parts. The first 
part is called A(1) and is 10 locations in size. The second part is 
called A(1l) and is 20 locations in size. The third part is called 
A(31) and is also 20 locations in size. The final declaration in the 
example is A or A(0) (both are equivalent), which allows access to the 
entire array A. This happens because the position in the array A _ of 
A(0) is less than the last declaration in the USE statement, i.e., 
A(31), and a new partitioning is started. This new partitioning 
begins at A(0) and proceeds until the end of the array A. The rules 
to continue from this point are the same as previously discussed _ and 
further partitioning could be defined if necessary. Note that every 
declaration in the USE statement must be unique, i.e., a statement of 
the form USE(A,A(0)) results in the first array A having an area of 
zero length. Since the second array is not unique in name, any 
reference to it later by other LPS statements actually refers to the 
array A and not A(0). Since A has zero length, the buffer declaration 
is useless. 


2.3.2 Allowing Access to a Buffer (ACC) 


ACC 


The ACC routine allows full access to the specified array by the RDB 
routine. The form of the call is: 


CALL "ACC"(A[(i)]) 
where 


A[(i)] is a buffer previously declared in acall to the 
USE routine. 


A call to ACC resets all buffer pointers of the array A to allow full 
access to it by the RDB and PUTD routines. The PUTD pointer is placed 
at the end of the array and the RDB pointer is placed at the 
beginning. Since the PUTD pointer is placed at the end of the array, 
the buffer is considered full. 


Example: 
Allow full access to the array H and the buffer area of array A. 


10 DIM A(25) ,H(20) 

20 CALL “USE"(A(1) ,A(11),A(31) ,A,H) 
30). aces 

ere 


ee 


100 CALL "ACC" (H) 

110 CALL "ACC" (A(11)) 
1200 2ss 6 

130; cess 
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2.3.3 Returning Data from a Buffer (RDB) 


RDB 


A call to the RDB routine returns the next data value from the 
specified buffer in the target variable. The value returned from RDB 
contains the data value with the gain in the most Significant digits. 
The returned data is formatted. The form of the call is: 


CALL “RDB"(A[(i)],B) 


where 
A[(i)] is a buffer previously defined in a call to the 
USE routine. 
B is the target variable. 


A call to the RDB routine returns values in B of 65535 to 0 for good 
data. A -1 will be returned if the data is bad (defined as software 
data overrun). A -2 will be returned if there is no data. A -3 will 
be returned if a hardware data overrun occurs. 


A ring buffer is the specified buffer used by the RDB, RTS, HIST, 
PUTD, and DRS routines. Data is withdrawn from the ring buffer by the 
RDB routine but inserted into the ring buffer by the RTS, HIST, PUTD, 
or DRS routine. Two pointers which are invisible to the users point 
to the last data added and the next to be withdrawn. 


If either pointer passes beyond the buffer, it is reset to. the 
beginning of the buffer. If a RDB routine is executed when no data is 
available, the pointer is not advanced. 


If a software data overrun occurs (that is, when there is no room in 
the ring buffer for data from the RTS, HIST, PUTD or DRS routine), 
then all subsequent calls on the RDB routine will return a -l. This 
will occur if the ring buffer is not large enough to contain all the 
data or the data is not removed from the ring buffer as fast as it is 
added. 


When the referenced buffer contains analog sampling data (RTS 
function), the values returned in B are in the range 0 to 4095 for the 
LPS1l and 0 to 1023 for the ARI11, with the gain in the most 
Significant bits. 


When the referenced buffer contains a clocked histogram sampling (HIST 
function), the values returned in B are in the range 0 to 65535. 
These values are either the number of ticks accumulated or the number 
remaining depending on the clock mode. 


When the referenced buffer refers to digital I/0 data (DRS function), 
a value between 0 to 65535 is returned in B from the next position in 
the specified buffer. 


Example: 
Assume that the array X has 100 data values previously entered by an 


RTS routine. Print out the data making sure that data overrun did not 
occur and that 100 data points were indeed taken. 


1A FOR Tai TO 186 
SE CAL d “bpm, Sy 
“A TF Bose THEN LE 
a TF Ss-1 THEM FA 
SO TF Fe-2 THEA FA 
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GG IF @=-% THEN 114 

7Q PRINT "RING SUFFER CWFRRUN, SFMPLING TOW FAST" I 
ea ac To 156 

Ga PRINT "NO DATA AT EVENT WET" I 

1ae GO To 144 

116 PRINT "HRROMARE DATA COWERRUN, SFIMFLING TOC FAST"; 1 
120 GO To 154 

430 PRINT 2 

440 NEXT 1 

45@ CONTINUE 

1.60 ENE 


RR APY 


2.4 MODULE LPS1 (A/D CONVERSION AND NUMERIC READOUTS) 


2.4.1 Analog to Digital Conversion (ADC) 


The ADC routine initiates an A/D conversion from the specified 
channel, waits for it to complete, and returns the conversion as a 
floating point result in A (in the range 0 to 4095 for the LPS11l_ and 
1023 for the ARI1). The A/D cannot be currently involved ina 
real-time sampling (RTS) operation. 


The form of the call is: 


CALL "ADC"(b,A[,i]) 
where 
b specifies the channel and must be in the _ range 
from 0 to 63 for LPS11 and 0 to 15 for ARII. 


A is the target variable and will contain the 
floating point conversion from the analog input. 


The value returned is as follows: 


A=data/gain (where gain=1,4,16,64) For LPS11 
with gain. 

A=data When the AR11 is in 
bipolar mode. A is 
always positive. 

A=-data When the AR11 is in 
unipolar mode. A is 
always negative. 


i specifies the gain setting for the requested A/D 
conversion on an LPS11, or the range (bipolar or 
unipolar) on an ARII. 


when 

i=0 software auto-gain ranging 

=] gain of 1 for LPS11 (-5V to +5V); bipolar 
range for AR11 (-2.5V to +2.5V), 

=2 gain of 4 for LPS11l (-1.25V to +1.24V); 


unipolar range for AR11 (0 to +5V). 


Zp 
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Example: 


=3 gain of 16 for LPS11 (-0.3V to +0.3V); 


illegal for ARI11. 


=4 gain of 64 for LPS11 (-0.078V to +0.078V) ; 


illegal for AR11l. 


The default value is l. 


NOTE 


On an LPS11, the LPSAG option must 
be present when i is not equal to 
1, otherwise the value returned in 
the target variable will be 
unspecified (i.e., dependent on 
hardware). 


Sample the A/D from channels 4 and 5, use a gain of 1, and _ save the 
results in arrays A4 and A5 respectively. Assume 100 samples are to 


be taken. 


LO TIM A$C100) yAGC1O0) 


2O FOR Ded TO 


LOO 


SO CALL "ANC" C49A4CT DD 
40 (ALL "ANC ' (Sy Ase dl) 


30 NEXT 1 


2.4.2 Real-Time Sampling (RTS) 


RTS 


The RTS routine performs real time buffered/clocked sampling of the 


A/D. 


The form of the call is: 


CALL "RTS"(A[(i)],cl,c2,n,m[,i]) 


where 
A[(i)] 


cl 


c2 


is a buffer previously defined in acall to the 
USE routine. The sampling will be stored in this 
buffer. The data pointers in the ring buffer 
will be reset before sampling is begun. 


determines the first channel to be sampled. Must 
have a value between 0 and 15 for AR11 or LPS11 
with gain other than 1 specified; or 0 to 63 for 
LPS11 with no gain or gain equal to l. This 
value must be between 0 and 7 when dual sample 
and hold is required. 


determines the number (or number of pairs) of 
sequential channels which will be sampled. The 
maximum is 16 for AR11l or LPS11 with gain other 


LABORATORY PURIPHERAL SYSTEM SUPPORT 


than 1 specified; and 64 for LPS11 with no gain 
Or gain equal to l. 


NOTE 
The sum of Cl and C2 cannot be greater 
the 64. 
n determines the total number of samplings. 
m determines the mode of sampling. 
i specifies the gain setting for the requested A/D 


conversion. 


when 
i=0 software auto-gain ranging 
=1 gain of 1 for LPS11 (-5V to +5V); bipolar 
range for ARI11 (-2.5V to +2.5V). 
=2 gain of 4 for LPS1l1l (-1.25V to +1.25V); 
unipolar range for AR11 (0 to +5V). 
=3 gain of 16 for LPS1l1 (-0.3V to +0.3V); 
illegal for. AR11. 
=4 gain of 64 for LPS11 (-0.078V to +0.078V); 


illegal for ARI11. 


The default value is 1. When (cl + c2) is greater 
than 16, it is illegal for i to be equal to zero 
or greater than l. 


NOTE 


On an LPS11, the LPSAG option must be 
present when i is not equal to Il, 
otherwise the value returned in the target 
variable will be unspecified (i.e., 
dependent on hardware). 


The A/D can be enabled in a variety of modes depending on the options 
specified. The normal mode of operation (m=0) causes the A/D to 
sample whenever Schmitt trigger 1 fires for the LPS11 or external 
Start for the ARI11. To enable other options, merely add their code 
number to the mode. The following table describes options available 
(all options are normally disabled): 
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Table 2-1 
Mode Options in RTS Sampling 


Normal operation, reads on Schmitt trigger 1 for 
LPS11 or external start for ARI11. 
Enable burst mode (used only with DMA) 


Enable clock, disable Schmitt trigger 1 (used with 
LPSAD12, LPSKW or AR11) 

Enable dual sample and hold for LPS11 only (used with 
LPSSH) 

Enable DMA for LPS11 only (used with LPSAD-NP) 


The burst mode can be used with Direct Memory Access only and the dual 
sample and hold mode can be used with the Direct Memory Access. The 
dual sample and hold, and DMA options can only be used on the LPS1l. 
The following table lists all possible values for m and the modes 
enabled. 


Table 2-2 
Mode for Values of m 


Schmitt trigger 1 or external start 
Clock 

Dual Sample and Schmitt trigger 1 

Dual Sample and Clock 

DMA and Schmitt trigger 1 

DMA and Burst 

DMA and Clock 

DMA and Burst 

DMA, Dual Sample, and Schmitt trigger l 
DMA, Dual Sample, and Burst 

DMA, Dual Sample, and Clock 

DMA, Dual Sample, and Burst 


The A/D is started by a clock overflow or the firing of Schmitt 
trigger 1 (external start for AR11). Pointers are used to determine 
if data exists in the buffer arrays or if data wrap-around occurs. 
Since data is stored in circular buffers (excluding DMA operations), 
pointers are used to ensure that the incoming data rate does not 
exceed the removal rate. Data returned as -l indicates ring buffer 
overrun; data returned as -2 indicates no data exist; data returned 
as -3 indicates hardware overrrun (interrupt service too slow). The 
buffer pointers are reset initially before the sampling operation 
begins. 


A/D channels are sampled on every clock overflow or firing of Schmitt 
trigger 1 (external start for AR11) with the result stored in 
consecutive data cells. Data is stored in a format identical to that 
read from the A/D (bits 0-11 for data and bits 11-12 for gain). When 
a clock overflow or Schmitt trigger firing occurs, the A/D samples the 
first channel specified by cl and then samples the next c2 minus 1 
consecutive channels. Sampling then continues until n clock overflows 
or Schmitt triggers have been received. If n is specified as zero, 
any previous RTS sampling will be disabled. 


In dual sample and hold mode, parameter c2 is the number of pairs of 


channels to read per sampling. Parameter n defines the number of 
samplings. There are 2*C2 elements per sampling. 


2-10 
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DMA operations may use dual sample and hold. DMA allows direct 
hardware storage of A/D results from only one channel into a specified 
buffer array. A maximum of 4096 data may be taken at any one time 
with removal of data allowed only when the buffer is completely 
filled: 


NOTE 


When DMA is used with dual sample _ and 
hold, the parameter C2 must be 1, BASIC 
automatically assigns the value of 1 to 
C2 and any other number that is assigned 
to C2 will be ignored. 


RTS operations do not interfere with sampling operations other than 
ADC (i.e., DRS and HIST routines) and all can be in progress 
Simultaneously. You must set up the clock by making a call to the 
SETR routine before calling the RTS routine. 


Examples: 


Set up the A/D to read data from channels 0 through 3 and _ store the 
results in the array A. Schmitt triggers are to be used to fire the 
A/D. Note that a dimension of 100 allows 200 data points. Since 4 
channels are to be sampled, 50 Schmitt triggers will be required to 
complete the request. 


bo UEM aed: 
ea Week) ad 


AQ CALL "RTS" Cy te de LOOK 44 OD) 


Cf 


2.4.3 Display on the Light Emitting Diodes (LED) 


LED 


A call to the LED routine displays the floating point value of the 
specified expression on the LEDs (Light Emitting Diodes) of the LPS1l. 
Up to six positive or five negative digits can be displayed in the 
LEDs. An optional decimal point can also be included. Numbers which 
cannot be accurately displayed (i.e., E numbers or 6-digit negative 
numbers) are shown as all minus signs. 


This routine acts as a NOP (no-operation) when SAR11 is defined in 
PERPAR.MAC for an AR11l system. 


The form of the call is: 
CALL "LED" (a) 
where 


a the expression or the value to be displayed. 


Example: 
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Display the value 5.632 on the LEDs. 


yoy oe a as 
LO ek, &30 


via 0 le OY 3) oe Gms fs 6 aa 2 
or 


ro CALL. “LEM "( S463 


2.4.4 Returning A/D Data from Buffer (CVSG) 
The CVSG routine returns the unformatted data value sampled by the RTS 
routine in one variable and the gain in a separate variable. A -1l 
will be returned if the data is bad (defined as overrun). A -2 will 
be returned if there is no data. A -3 will be returned when a 
hardware data overrun occurs. 
The form of the call is; 

CALL “"CVSG" (V,I) 
where 


V is the target variable and contains the floating 
point conversion from the analog input in the 
range 0 to 4095 for LPS11 and 0 to 1023 for ARII1. 


I returns the gain setting of the requested A/D 
conversion. 
when 
=] gain of 1 for LPS1l1 (+tor-5V); bipolar 
range for ARI11 (+or-2.5V). 
=2 gain of 4 for LPS11 (+o0r-1.25V); unipolar 
range for AR11 (0 to +5V). 
=3 gain of 16 for LPS1l1 (+or-.3V); illegal 
for AR11. 
=4 gain of 64 for LPS11 (+tor-.078V); illegal 
for AR11. 


2.5 MODULE LPS2 (REAL-TIME CLOCK) 
2.5.1 Setting the Clock Rate (SETR) 


A call to the SETR routine sets the clock running in the _ specified 


LABORATORY PERIPHERAL SYSTEM SUPPORT 
mode and at the designated rate. The interrupt enable is always set 
(except mode 8 and above). 
The form of the call is: 


CALL "“SETR"(r,m,p) 


where 
Lr determines the rate of the clock. 
m cletermines the mode of the clock. 
p is the preset value of the clock counter. The 


preset value must be less than 65535 (decimal) for 
the LPSKW and 255 (decimal) for the ARI11. 


The following preset values are illegal for the indicated rates in 
interrupt mode. 


Rate Illegal preset values 


1 <150 
<180 (for systems with memory management option) 


2 <15 
<18 (for system with memory management option) 


2 =] 


NOTE 


All values of rate and preset are legal in 
interrupt mode. 


The following tables describe the rates and modes determined by the 
values of r and m. 


Table 2-3 
Selecting the Clock Rate 


Values of r 


No rate selected 
il MHz 

100 kHz 

10 kHz 

1 kHz 

100 Hz . 
Schmitt trigger 1 (external event for AR11) 
Line frequency (50 Hz or 60 Hz) 


SDS WNE © 


LABORATORY PERIPHERAL SYSTEM SUPPORT 


Table 2-4 
Selecting the Clock Mode 


Values of m 


Single interval mode. Counter counts from preset value _ to 
overflow and stops. 


ui Repeated interval mode. Counter counts from preset value to 
overflow, transfers buffer/preset register to the counter, 
and begins again. 


2 External event timing mode. The counter is free running, 
and a pulse from Schmitt trigger 2 transfers contents from 
the counter to the buffer/preset register and then continues 
counting. Not valid for ARI1. 


3 Event timing from zero base mode is the same as mode 2 
except when the transfer of the counter to the buffer/preset 
register is done, the counter is cleared and the count 
begins from zero. Not valid for ARI11l. 


4,5,6,7 Start clock only after Schmitt trigger 1 fires. Mode is 
then determined by the value of m-4. Not valid for ARI1I1. 


8 to 15 Indicates the operation of the clock in a non-interrupt mode 
has been added for faster A/D data acquisition. To get the 
value of m, just add 8 to the value of the interrupt mode. 
For example: 


m=0+8 indicates single interval non-interrupt mode clock 
operation. 


m=1+8 indicates repeated interval non-interrupt mode 
clock operation. 


Example: 


Set the clock running to interrupt once every second. A 100 4Hz 
frequency is used and the clock mode is l. 


CALL "SETR"(5,1,100) 
Each programmable clock interrupt causes a 16-bit software clock 
(counter) to be incremented by one. When the maximum count of 65535 


is reached, the next interrupt causes a reset to zero. This clock may 
be retrieved by the RTIM and DRS routines. 


2.5.2 Setting the Clock to Rate and Time (SETC) 


SETC 


A call to the SETC routine sets clock to specified rate and time. 
The form of the call is: 


CAEL "SETC" (r,t) 
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where 


ig determines the clock rate as described in 
Table 2-3, and may be 4,5, or 7. 


t is the time in seconds that the clock runs’ before 
issuing an interrupt. 


The clock status register is set to rate determined by r and runs’ for 
t seconds. A clock interrupt then occurs which can be used to 
initiate any of the clock controlled functions. The time argument is 
evaluated as ticks equal time in seconds multiplied by the clock rate 
specified, e.g., if the clock rate was 10kHz, then ticks equal time in 
seconds multiplied by 10kHz. The ticks are entered into the clock 
preset/buffer register. The clock always runs in mode 0. 


Example: 
Set the clock to interrupt in 10 seconds using a 100 Hz frequency. 


CALL "SETC" (5,10) 


2.5.3 Histograms - Timed Schmitt Trigger (HIST) 


HIST 


The HIST routine inputs values from the clock preset/buffer register 
and stores them into the specified buffer whenever Schmitt trigger 2 
fires. The clock must be in mode 2 or 3 for the data to be 
meaningful. 


The form of the call is: 
CALL "HIST" (T[(i)],n) 
where 


T[(i)] is a buffer previously defined in a call to the 
USE routine. 


n determines the total number of data points stored. 


The RDB function is used to retrieve the data. The data pointers in 
the ring buffer are reset before the sampling operation begins. 


If n is given as zero, the HIST sampling will be disabled. 


HIST operations do not interfere with other sampling operations (i.e., 
RTS and DRS) and all can be in progress simultaneously. 


HIST routine acts aS a NOP (no-operation) when SAR11 is defined in 
PERPAR.MAC for an AR11 system. 


Example: 


Collect a timed histogram between external events (Schmitt trigger 2) 
and store the results in array T. The clock runs at 1 kHz and 100 
intervals are required. 


LO TEM TOO) 

20 CALL "USE" OT) 

AQ CALL "HIST" (T2100) 
AG CALL "SETR' C49 ae] 
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2.5.4 Delaying Program Execution (WAIT) 


WAIT 


A call to WAIT disables further program execution until the specified 
event occurs. 


The form of the call is: 


CALL "WAIT" (n) 


where 
n specifies the event that must occur for program 
execution to continue. 
Values of n are: 
n=0 Wait for clock to overflow only. 
n=l Wait for Schmitt trigger 1 (external event 
for AR11) to fire (for clock rate = 6 only). 
n=2 Wait for clock to overflow or Schmitt trigger 
1 to fire. 
n>2 Returns immediately. 
n<0 Wait for Schmitt trigger 1 (external event 
for AR11) to fire (a call to the SETR or SETC 
routine must be made prior to this). 
Example: 


Wait for clock to overflow. 


10 CALL "WAIT" (0) 


2.5.5 Returning Current Software Clock Tick Value (RTIM) 


A call to the RTIM routine returns the 16-bit integer value of the 
internal software clock counter maintained by the programmable clock. 
The form of the call is: 
CALL "RTIM"(s,t) 
where 
s specifies whether the internal clock counter is to 
be cleared or not. The counter is cleared when s 


is equal to 0; otherwise it is unaltered. 


t is the 16-bit integer value of the internal clock 
counter. 
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2.6 MODULE LPS3 (DIGITAL I/O) 


The user should read the LPS11 Laboratory Peripheral System User's 
Guide in order to fully understand the hardware latching mechanism 
before using these modules. 


The interrupt control logic permits the LPSDR-A or the DR11-K_ to 
perform an interrupt operation. The switches and jumpers on this 
logic can be arranged so that vector address can be assigned other 
than those configured as standard on the module for alignment. 


One method of causing interrupts to the Unibus uses the two control 
lines between the DRI11-K and the external device. If the input 
interrupt enable (bit 6 of the status register) is set, a negative 
transition (+3 v to ground) of the EXTERNAL DATA READY pulse will 
generate an interrupt to the Unibus, with a vector address of 300. A 
bus request is made on the BR level that corresponds with the level of 
the priority plug in the logic (the standard level for the DR11-K 
interface is  BR4; this may be changed on the priority plug if 
desired). The control line method of interrupting is logically ORed 
into the DR11-K interrupt control, and is disabled by internal 
clamping circuitry if not deSired. The device will continue 
interrupting as long as the line is held low. 


The second and most preferred method of interrupting is to use _ the 
individual input lines. Each input (IN15:INOO) is buffered by a 
flip-flop that will set on a negative transition (+3 v to ground). 
Switches for the buffered bits on the hardware option make it possible 
to wire-OR each bit onto a common interrupt line. When the input 
interrupt enable (bit 6 of the status register) is set and a switch is 
on, the transition of the associated bit causes an interrupt to the 
Unibus. The bits are read under program control by reading the input 
register, and are cleared by moving data 1s to the bits to be cleared. 
The input interrupt enable is cleared when an input interrupt is 
accepted by the Unibus; when reset, it will retrigger the interrupt 
circuit if any other input bits were set during the program service 
Subroutine, so that new interrupting bits will not be lost. 


2.6.1 Reading the Digital Input Register (DIR) 


ee Se I 


A call to DIR reads the Digital Input Register and converts it to a 
floating point number. The form of the call is: 


CALL "DIR"(i,V,S[,m[,j]]) 
where 
i determines the type of floating point conversion. 


V is the target variable. It is the value in the 
input register ANDed with m. 


S contains the returned digital Control Status 
Register (CSR) setting. 
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m indicates the 16-bit mask. The default value is 
-l. 


5 indicates the number of the DRI1-K unit on a 
multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
Parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 


If i=0, input is four Binary Coded Decimal (BCD) digits converted to a 
floating point number and the result is in the range 0 to 9999. If 
i<>0, then the binary result read from the register is directly 
converted to a floating point number and the result is in the range 0 
to 65535. The Digital Input Register is read via an internal load 
request and does not respond to interrupts. The input word is 
immediately written back into the input register to clear those bits 
which were obtained from the register. The result is returned in V. 


The new CSR register setting is returned in S. 
Example: 


LoREM THIS FROGKAM TESTS THE "TOR" y "COR" ANT SRS" MORULES ALONG WITH 
2 REM SETRYyWALT AND ROB. THE TNFUT ANT THE OUTRUT TGITAL CABLES MUST 
3 REM CONNECTED TO EACH OTHER. 

4 OGM xX¢3O) 

we Oe 

& CALL "MOR" Cy GSS 35 9 N) 

7 CALL "USE" CX) 

LQ FOR Tekh TO 14 

2O CALL "OO" ¢O¥09N) 

SQ CALL "TER" Cl» Ye NID 

40 FRINT Noy 

wa Ce (ae 

SO NEXT T 

160 CALL "TOR" C1» GSS» No 
LoS CALL "URS" CxXe ly SOx»O9N) 
170 CALL "SETR® C39. 100) 
L725 Meo 

180 Oeg 

Les FOR Ted TO 30 

120 CALL "MOR" Ch sy GSU 3c Nd 
LPS CALL "MOR * (Ms OQ9N) 

POO DHO4+ dO atonal Gt. 

2OS CALL "WATT" ¢O) 

21O NEXT I 

215 GUSUB BOO 

220 STOF 

SOO FUR wed TO 3 

SOS CALL "RIM" CX 9 

ALO PRINT Jy ¥ 

S15 NEXT J 

BAO RETURN 

SOO ENT 
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2.6.2 Writing to the Digital Output Register (DOR) 


A call to DOR can either set or clear selected bits in the Digital 
Output Register. The form of the call is 


CALL "DOR" (m,n,R[,j]) 
where 


m determines whether bits are to be set (when m=0) 
or cleared (when m is not equal to 0). 


n determines which bits are to be set or cleared. 


R contains the floating point equivalent to the new 
value in the Digital Output Register. 


5 indicates the number of the DRI1-K unit on a 
multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 
If a bit in the binary representation of n is 1, the corresponding bit 
of the Digital Output Register will be cleared or set (depending on 
the value of m). If a bit in the binary representation of n is 0, the 
corresponding bit of the Digital Output Register will not be changed. 
The BASIC-11 BIN and OCT functions are very useful in setting or 
clearing the registers. 
Example: 
Turn on (set) bits 1 and 2 of the Digital Output Register. 
40 CALL "DOR"(0,BIN'110',N) Clear Digital Output Register. 
40 CALL "DOR"(1,0CT'177777' ,N) 
or 


40 CALL "DOR"(1,-1,N) 


2.6.3 Digital Readout Sampling (DRS) 


A call to the DRS routine samples the Digital Input Register in a 
Similar fashion as the RTS function. 


The form of the call is: 
CALL "DRS" (A[(i)],ml,n,m2,R[,T{,m[,j]]]) 


where 
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Af(i)] is a buffer previously defined in a call to the 
USE routine. 


ml determines the mode by which the Digital Input 
Register is to be read. 

n determines the total number of samplings. 

m2 determines whether the sampling is clock driven. 

R contains the returned setting of the digital 


Control Status Register (CSR). 


T describes the address of the buffer to store the 
current clock TICK value on every data interrupt 
when m2 is not equal to zero. 


m indicates the 16-bit mask. The default value is 
-l. 
5 indicates the number of the DRI11-K unit on a 


multiple DR11-K system. The default value is 0. 
The maximum legal value is determined by the 
parameter SNUMBER in PERPAR.MAC at the assembly 
time of PERVEC.MAC module. 


When m2 is equal to 0, each time the clock fires (Schmitt trigger, or 
external event for AR11), the Digital Input Register is read. 


If ml is equal to zero the Digital Input Register will be treated as 
Binary Coded Decimal and will be converted to binary. If ml is not 
equal to zero the Digital Input Register will be input directly as a 
binary number. This number is stored in the circular buffer specified 
by A[(i)]. When DRS is first called, it resets the pointers of the 
buffer to the beginning. 


If n is given as zero, the DRS sampling will be disabled. The DRS 
call is driven by digital clock when m2 is not equal to zero. 
Whenever a new value is received in the input register, the value is 
immediately read in and stored in the buffer. The value of the 16-bit 
software clock is stored in the buffer specified by T. The input data 
word is immediately written back into the input register, and the 
active bit which have been sampled are cleared. 


The new setting of the digital Control Status Register is returned in 
R. 


Example: 


Read the Digital Input Register once every one tenth of a second _ for 
100 readings and store the results in array A. 


LO YUM ACSO) 

29 CALL "USE" CAD 

30 CALL "URS" (Av Gs 1LO0v0N) 
4QO CALL "SETH" (CSri219) 
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2.6.4 Relay Control (REL) 


REL 


A call to the REL routine opens or closes the specified relay. 


The REL routine acts as a NOP (no-operation) when SAR11 is defined in 
PERPAR.MAC for an AR11 system. 


The form of the call is: 


CALL "REL" (a,b) 


where 
a specifies the relay and may be equal to 1 or 2. 
b determines the operation. Relay is opened if 
equal to 0, otherwise it is closed. 
Example: 


Open relay 1 and close relay 2. 


LOO CALL "REL" Cl») 
LhO CALL "REL! C29 1) 


2.6.5 Reading/Writing Data From/Into Memory (IPK) 


The IPK routine can be called to read a value from a specified address 
or place a value into a specified address. The form of the call is: 


CALL "IPK"(s,a,V) 
where 


s indicates whether the value is a word or ae byte. 
If s is even, the word value supplied in V will be 
read from or written into the even address 
register. If s is odd, the byte value supplied in 
V will be read from or written into the _ odd 
address register. 


A call such as CALL "“"IPK" (0,64,V) reads into 
variable V the value at location 64 in memory. 


a specifies the address where the value V is read 
from or written into. This address must be even 
when the value of s is even. This address can be 
specified as an octal string, integer constant or 
integer variable. 


A call such as CALL "IPK" (2,73,100) is illegal 
because the address is odd; the error message 
?ARG will result. 
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V is the value to be read from or written into the 
address register. 
NOTE 
This routine should not be used except to 
read from or write into the I/O page or to 
read from memory. Writing into memory can 


cause serious consequences (program being 
wiped out, etc.). 


2.7 MODULE LPS4 (DISPLAY) 


The routines in this module require the LPSVC or AR11 with the VR14 
interfaced through it. The VT1ll cannot be used with these routines. 


2.7.1 Defining the Display Buffer (CLRD) 


CLRD 


A call to the CLRD routine defines the display buffer having fixed 
delta x values. 


The form of the call is: 


CALL "CLRD" (A[(i)],a,b) 


where 
A[(i)] is a buffer previously defined by a call to the 
USE routine. 
a specifies the size of the buffer to be displayed. 
b specifies the scale. 
The buffer to be displayed should contain Single word values. Values 


in the range 4095>=value>=0 are displayed while values outside this 
are not. The size of the buffer, a, is the number of Y points’ to 
display and must be less than or equal to the number of points defined 
in the DIM statement and the call to the USE routine. The delta x is 
calculated as 4096/a and can be fractional. 


If b, the scale, equals 0, CLRD will set all buffer values to -1l 
(non-displayable values). If scale does not equal 0, CLRD bypasses 
the clearing of the array and the original data is multiplied by b. 
In either case, the PUTD pointers are reset to point to the beginning 
of the array. Data is entered into the array through the PUTD 
function; however, a CLRD must be issued before data is initially 
transferred to the array. 


A CLRD routine must be issued at least once before issuing the DIS, 
FSH, or DXY functions which can display the buffer defined by CLRD. 


Example: 
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Set up the array C to be used as a display buffer having 256 points. 
LO TEM C128) 
20 Cal "USE" C0} 
SO CALL "ChE" (09 28690) 


2.7.2 Putting Data into Display Buffer (PUTD) 


A ane sn a 


PUTD 


A call to the PUTD routine puts a data value into the specified 
buffer. Repeated calls to PUTD will cause the buffer to be filled 
sequentially. 


The form of the call is: 
CALL "PUTD" (A[(i)],b) 


where 


A[(i)] is a buffer previously defined by the USE routine. 


b is the value to be inserted. Must be in range 
0<=b<=65535. 


This function does not initiate a display, but rather just enters data 
into the specified array. 


Example: 


Remove 100 data points from the specified digital sampling buffer D, 
and transfer them to the buffer Z. 


BO YIM OeSOdy XCO) 
SO CALL "USE" (tly x9 
100 FOR T#1 TO 100 
110 CALL "ROR! Clty X) 
$20 CALL "PUTT" (2 9X) 
130 WEXT Tf 


2.7.3 Background Display Routine (DIS) 


A call to the DIS routine displays data from the buffer whenever BASIC 
is idle. Data is not displayed by DIS or DXY routines under RT-1l FB 
system because BASIC is never idle. Data is displayed under RT-1l SJ 
system (version 2 or later) only when I/O is taking place. 


The form of the call is: 
CALL "DIS"(A[(i)],a,b[,n]) where 


A[(i)] is a display buffer previously defined by the USE 
and CLRD routines. 
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a determines the starting point of the display. 


b determines the frequency of points in the buffer 
that are to be displayed. 


n specifies the number of data point to display. 
The default value is all remaining elements of the 
array. 


The points displayed start with the point a in the buffer and proceed 
in increments of b. If b is equal to 1, consecutive points starting 
with the a one are displayed. If b is equal to 2, every other point 
is displayed, etc. 


Example: 


Display data from buffer E beginning at the 12th data point = and 
displaying every 3rd point of the remaining array elements. 


2O TIM E CLOG? 

40 CALL "USE" CE > 

SO CALL "CLR" CE y 20090) 

SO REM BUFFER MAY BE FALE HERE 
LOO CALL "TIS" CE» Lee a) 

P20 REM OR MAY BE FILLED HERE 


Example: 


~ REM THIS FROGRAM TESTS THE ROUTINES-USE sCLRTy PUTO y OTS» PF SH-ALONG WITH 


LO REM SETRy ANT WALT 

LS PRINT "PROGRAM TO TEST CLRDvPUTOy OTS ANT FSH." 
WO CALL "SETR" Ole tly 1) 

LOO OTM ACTOO) 

290 CALL "USE" CA) 

S00 CALL "CLRT" (fy 1OG9O) 

400 FOR Ted TO 100 

SOO CALL "PUTT" Cay D3 

400 NEXT I 

FOO CALL "OIG" Che dy 1) 

YO TNRUT 

PaO CALL "ULG" (Ay dey dy 7m) 

YéG INFUYT 1 

YOO PALL "IS" (Av Lely SO) 

BOO INPUT 0 

POO TF Teood TO 2000 

OOO FOR Sed TO ey 

7S FOR Ted TO So 

POO FOR Ced TO 100 

LOGO CALL "FSH" CavyS~ Tet) 

LOLO CALL "Warr" ¢o) 

LORS NEXT 0 

LOSOQ NEXT T 

LOGO NEXT & 
L1LO0 GO TO 8oo 
£000 STOF 


ae 
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2.7.4 Display Buffer (FSH) 


The FSH routine is identical to the DIS routine except that the data 
points in the buffer are completely displayed only once when this call 
is executed. The next BASIC statement is then executed. 

The form of the call is: 


CALL "FSH"(A[(i)],a,b[,n]) 


where 

A[(i)] have the 

a same 

b meaning 

n as in DIS. 
Example: 


Using the previous example, display 100 cycles of the array E. 
100 FOR Ted TO 100 


L1O0 CALL "FSH" CEs ley 3) 
$20 NEXT T 


2.7.5 Displaying X,Y Data (DXY) 


DXY 


A call to the DXY routine displays points from two buffers as x and y 
values. These buffers are displayed whenever BASIC is idle. Data is 
displayed under RT-11 SJ system (version 2 or later) only when I/O is 
taking place. 


The form of the call is: 


CALL "DXY" (X[(i)],Y[(j)],a,-bI[,n]) 


where 

X[({(i)] is a buffer previously defined by. a call to the 
USE routine and contains the x values. 

Y[((j)] is a buffer previously defined by calls to the USE 
and CLRD routines and contains the y values. 

a determines the starting point in both buffers 

b . determines the frequency of the points in each 
buffer to be displayed. 

n specifies the number of data points to display. 
The default value is all remaining elements of the 
array. 


2-25 
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The buffer containing the x values, xX[(i)] does not have to. be 
initialized by a call to CLRD, but it may be convenient to do so to 
initialize all values so that they are non-displayable. The buffer 
containing the y values must be initialized by a call to CLRD although 
the value of delta x is not used. 


As in the other display routines the a determines the location of the 
first point to be displayed in each buffer and b determines the 
frequency of points to be displayed. If b equals one, consecutive 
values are taken from the two buffers. If b equals two, every other 
value in each buffer will be used to create the display. 


Example: 


Generate fiducial marks on the display screen of a 256-point display 
every 16 points. Marks will be 10 points in height. Data will be 
generated into the arrays X and Y. 


S REM THIS PROGRAM TESTS -leh AND FXY- ROUTINES 
1G PRINT "TEST PROGRAM FOR CX ANC Ft ROUTINES" 
SH DIM Hea2es. WCLe8 

SA CALL "LSE" CH, 4 

a6 CALL "CLEDU CK, 286, a 

FA CALL "CLEMO, 256, 

eG FOR [=16 TO e56 STEFF 16 

re FOR J=4 To 1 

RA CALI "PUTO EX, 1) 

96 CALL. "PUTDS CY 2) 

148 MEXT J 

118 NEXT 1 

128 CALL "ORY CRN 1) 49 

12a STOF 

146 ENG 


REAC 4! 


2.7.6 Flashing X-Y Data (FXY) 


FXY 


The FXY routine is the same as DXY routine except that the xX and Y 
values are displayed only once when this call is made. 


The form of the call is: 


CALL "FXY"(X[(i)],¥[(j)],a,b[,n]) 


X[(1)] Have the 
Y[(j)] same 

a meaning 
b as in 

n DXY. 


Example: 


sa REM THIS FROGRAM TESTS -fet AMD Fett- ROUTINES 
1@ PRINT "TEST PROGRAM FOR OXY AND FRY ROUTINES" 
“A PIM ACLeea, YCLeso 


S84 CHL. “USE xa SD 
Th CALL "“CLEE Ok, Sha. 3 
el: CAI. OU CSS oe A 
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BG FOR T=té TO 286 STEP 


Ta FOR Jat TO 1a 

AG CALL “PUTO ER, To 

GA CALL “PUT cd, I 

18@ NFRT J 

1146 NERT I 

Lea CALL "DRY" ee Gd. ao 
LEQ INPUT fr 


14@ CALL "Geeks Ys. did. oo 


150 INPUT [3 

16@ CALL "BRYN ER YL dd, 
1?@ IMFUT ff 

16@ IF h=@G0 TO eee 
13h FOR SSL Th:39 

aae FOR T=1. TO Se 


ale FOR M=L TO Lae 


“2A CALL "URRY CK. GY. &. 0, lo 


23G NEXT fh 
#4G NEXT I 
e50 NEXT S 
260 STOP 
AP a ENT 


REALTY 


2.8 HARDWARE REQUIRED FOR LPS COMMANDS 


The following 
utilize the LPS system. 


Summary describes 


the hardware necessary to 


Command Hardware Required 

USE None 

ACC None 

RDB None 

ADC LPSAD-12, LPSAM (for additional 8 channels) 

RTS LPSAD-12, LPSAD-NP (for DMA operations) 
LPSAM (for additional 8 channels) 
LPSSH (for dual sample and hold) 
LPSKW (for real-time clocking and Schmitt 
triggers) 
LPSAG-VG (for multi-gain) 

LED LPSAD-12 

CVSG None 

SETR LPSKW 

SETC LPSKW 

HIST LPSKW 

WAIT LPSKW 

RTIM LPSKW 

DIR LPSDR 

DOR LPSDR 

DRS LPSDR 

REL LPSDR 

IPK None 

CLRD None 

PUTD None 

DIS LPSVC 

FSH LPSVC 

DXY LPSVC 

FXY LPSVC 


fully 


The routines that require the AR11 are ADC, RTS, SETR, SETC, WAIT, and 


RTIM. 
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The routines that require the VR14 in addition to the AR11 are DIS, 
FSH, DXY, and FXY. 


The routines that require the DR11-K are DIR, DOR, and DRS. 


2.9 EXAMPLE PROGRAMS 


Lo REM THIS FROGRAM TESTS THE "ANC" MOMUILIE 

2 REM IT REQUIRES 2 INPUTS? CHANNEL i AND IGAIN FROM CONSOLE 
3 REM A CHANNEL d EQUAL TO «1 TERMINATES FROGRAM 
LO TNFUT C 

2O INFUT G 

$0 TF Cred THEN 100 

40 TALL "ANC" C9 V) 

SO PRINT Ve ARS CU) 

SO CALL "AVC ™ (ly Viv 1) 

7O PRINT Viv ARS CUI) 

BO CALL "ANC" (ly WVe»G) 

PO FRINT Vy ABS CUR) 

95 GO TO 160 

LOO END 


kk 


L REM THIS FROGRAM TESTS THE ORS MODULE TIME LOG FEATURE 
3 YIM 2630) 

4 NIM X¢€3Q) 

ae Qed 

> CALL "HOR" CLs 65535 9N) 

3 CALL "USE" (X92) 

LO FOR ft TO 164 

2O CALL "“QOR" CO»09N) 

30 CALL "OER" Cl» feN1o 

40 FRINT Noy 

30 f= (Ke 

60 NEXT I 

160 CALL "DOR" Cl sy 45534 9N) 

L465 CALL "RG" (Xely3OulyNy2y 7) 

166 FROIN T SGROGOIOIOIOK " y Noy “OROIIOOIGK OK ROK " 

170 CALL "SETH" C49 191) 

L7G Meo 

180 O06 

185 FOR T=) TO 30 

L390 CALL "TOR" C1» 6535 9N) 

19S CALL "DOR" CM» OQsN) 

200 D=Q+eetl sed. 

“lO NEXT I 

215 GOSUB 300 

229 STO 

300 FOR Jed TO 30 

JOG CALL "RIB" CX» ¥) 

396 CALL "ROB" CZ» YL) 

SLO PRINT Jv ¥9 Vd 

S15 NEXT JJ 

SAO RETURN 

JOO ENT 

* 

1@ RFM THIS FROGRAM TESTS THE "RTS" MODULE 
“@ REM TT REGUIRFS = INFUTS: STARTING CHANNEL #. NUMBER CF CHANNELS 
=e RRM ANE TGAIN FROM CONSOLE 

46 RFM A STARTING CHANNEL # FGUAL TO -1 TERMINATES PROGRAM 
SA TIM Acasa. 


fa 
ra 
Fa 
ae 
1 HG 
1164 
12@ 
128 
144 
450 
168 
417A 
166 
9a 
“Be 


(oa | fast i 


PU AP W WAI AIA A 


od P. 


Fr G10 
(Ea ay oS Ue i im 


REA 
* 

2k 
OF 
3 OR 
AR 
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CRIA "LSE" CAD 

INFLUT S 

IF S=-14 THEN 154 
INFUT WN 

INFLUT G 

CALL "SETRE" C8, 4, Lea) 
CALI "RTS"CA, SM, 2e, 2. G3 
GOSUE 2ee 

Go Ta Se 

STCF 

CALL. “RRA EA, 25 

TF é@ THEN 41°68 

RE TURN 

FoR [=1 Ta 4 

GOSUE 178 

AL=2 

GOSUE 17a 

AZ=? 

GOSUE 17a 

Ee< 

GOSUB tFa 

Ad=2 

GOSUE TPe 

Aas 

PRINT AL, Ag, AE, Ad, AS 
NFERT I 

RETURN 

ENT: 


ch! 


EM THIS PROGRAM TESTS THE "RTS" & "CUSG" ROUTINES 
EM IT REQUIRES 3 INPUTS? STARTING CHANNEL ds NUMBER OF CHANNELS 
EM ANY IGAIN FROM CONSOLE 
iM A STARTING CHANNEL d& EQUAL TO =. TERMINATES FROGRAM 
NIM AC20) 
CALL "USE" CAD 
INFUT S$ 
TF Seed THEN LOO 
INFUT N 
INFUYT G 
CALL "SETR" CS ed» 100) 
CALL RTS’ (Ay Sy Ny 20929) 
GOSUR 220 
GO TO 10 
ST Or 
REME CEC EECER ECR EEECEREEEREREEREREECRREEREEEREEREERREERRRREER 
CALL "CVSGO" (ZV) 
IF 22 THEN 200 


) RETURN 


FOR Tei TO 4 


3 GOSUER 200 


AL#Z 


jy 


GOSUB ROO 
Aga gz 
YUunlY 
GOSUE 2060 
AS#Z 
Usa 
GOSUB BOO 
Agia? 
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2995 Vaal 
300 GOSUE 200 

S10 ASeZ 

S18 USey 

320 PRINT AL» AZ A32A49 AS 

325 PRINT Vie V2eV39V49V5 

350 NEXT I 

400 RETURN 

1000 END 

* 

1 REM THIS FROGRAM TESTS THE "RTIM" MODULE ALONG WITH SETR ANID WALT 
2 REM THE LAST 1O VALUES PRINTED WILL BE O THRO’ 9%, 
10 INFUT 8 

20 IF S#—1 THEN 1000 

30 CALL "RTIM" (Or) 

40 PRINT V 

50 CALL "SETR" (5919100) 

60 FOR T=. TO 10 

7O CALL "RTIM"¢19¥) 

80 PRINT V 

90 CALL "WAIT" CO) 

100 NEXT 1 

110 GO TO 10 

1000 STOF 


k 


APPENDIX A 


COMMAND SUMMARY 


The following list is a summary of the routines available for 
controlling LPS hardware and a brief description of each: 


CALL ARGUMENT LIST EFFECT 


USE (AC (i) ] [BE (j)]~..-C[(£)]]) 
Defines array(s) to be used _ for 
storage of data. 


ACC (A[(i)]) Allows access to an entire array. 


RDB (A[(i)], B] Returns the next data point from a 
specified buffer. 


ADC (b,A[,i]) Initiates an A/D conversion on a 
specified channel and return the 
result to the user. 


RTS (A{(i)], cl,c2,n,m[,i]) Performs real-time buffered/clocked 
sampling of the A/D. 


LED (a) Displays a numeric value on the 
Light Emitting Diodes. 


CVSG (V,1I) Returns the next data value = and 
gain in two separate variables. 


SETR (r,m,p) Sets clock running at a designated 
rate and mode. 


SETC (r,t) Sets clock running at a_ designated 
rate and initiates some action 
after a specified number of seconds 
have elapsed. 


HIST (TL (i)] .n) Performs histogram sampling using a 
timed Schmitt trigger. 

WAIT (n) Waits for a specified event to 
occur. 

RTIM (s,t) Returns the value of the internal 
software clock counter. 

DIR (i,V,S[,m[,3j]]) Reads Digital Input register. 

DOR (m,n,R[,j]) Writes Digital Output register. 


CALL 


DRS 


REL 


IPK 


CLRD 


PUTD 


DIS 


FSH 


DXY 


FXY 


COMMAND SUMMARY 


ARGUMENT LIST 


EFFECT 


(A[(i)],m1,n2,m2, R[,T[,m[,j]]]) 


(a,b) 


(s,a,V) 


(A[(i)],a,b) 


(A[(i)],b) 


(A[(i)], a,b[,n]) 


(A[(i)],a,b[,n]) 


(X[(i)]-/-Y[(j)],a,b[,n]) 


(X[(i)],Y((j)],a,b[,n]) 


Performs sampling of the Digital 
Input register. 


Closes or opens one of two relays. 


Reads a value from a register or 
writes a value into a register. 


Defines display buffer and 
optionally clears or scales’ the 
data in it. 


Puts data into data buffer. 


Displays data with constant x. and 
variable y whenever BASIC is 
waiting for I/O. 


Displays a complete sweep of data 
with constant x and variable y. 


Displays data with variable x and y 
values whenever BASIC is waiting 
for I/O. 


Displays data with variable X and Y 
values respectively only once. 


APPENDIX B 


BUILDING LOAD MODULES 


B.1 BASIC/RT-11 


B.1.1 LPS Support 


The software supplied supports the standard hardware configuration 
only. The standard hardware configuration is determined by the 
address of the device hardware register and vectors. The standard 
LPS11 or ARI11 register is at 170400 (octal) and the vector is at 340 
(octal). The standard DR11-K register is at 167770 (octal) and vector 
is at 300 (octal). 


The supplied software has to be reassembled and relinked if the 
hardware configuration does not correspond to the above. To redefine 
the hardware register and vector address, just edit the source file 
PERPAR.MAC. 


The LPS Support for BASIC/RT-11 is supplied in ten binary relocatable 
files (on DECpack disk, DECtape, floppy disk, or 9-track magtape). 
These files are: 


LPSO.OBJ Required LPS kernel module for LPS11l or 
AR11 and DR11-K 
LPS1.OBJ Optional Analog to digital conversion 
for LPS11 
ARD1.OBJ Optional Analog to digital conversion 
for AR11 and DR11-K 
LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS1l 
ARD2.OBJ Real-time clock for AR11 (60 
One is required Hz line frequency) and DR11-K 
LPS2C.OBJ Real-time clock (50 Hz line 
frequency) for LPS11l 
ARD2C.OBJ Real-time clock (50 Hz line 
frequency) for AR11 and DR11-K 
LPS3.OBJ Optional Digital input/output for LPS1l 
ARD3.OBJ Optional Digital input/output for ARI11 
and DR11-K 
LPS4.OBJ Optional Display for LPS1l or AR11l and 
DR11-K 
The following files are also provided in source form in all kits: 
FTBL.MAC Function Table Module 
PERVEC .MAC Vector Definition Module 
RTINT.MAC Interface Module 
PERPAR.MAC Parameter 


To build a load module BASLPS.SAV (BASIC with LPS11 support) or 
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BASARD.SAV (BASIC with AR11 and DR11-K support), first transfer all 
BASIC Extensions binaries (including sources) and BASIC files to the 
System device with PIP. The parameter file PERPAR.MAC is then edited 
and assembled with FTBL.MAC, PERVEC.MAC, and RTINT.MAC. The three 
object modules produced are then linked with the LPS and BASIC object 
modules to produce a load module. 


NOTE 


All of the procedures in this’ section 
assume that an unaltered PERPAR.MAC is 
being edited. It is recommended that a 
copy of the original PERPAR.MAC be made 
and saved for future use. 


If the display module is not included in the LPS support to be linked, 
another background routine may be linked with BASIC, but- it must be 


defined in this module. See Section 8.8.1 of the BASIC/RT-11 Language 
Reference Manual for instructions to define the background routine. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table as described in 
Section 8.2 of the BASIC/RT-11 Language Reference Manual. FTBL.MAC is 
a function table in source’ form. If any user-written assembly 
language routines are also linked with BASIC and LPS' software, the 
routines must be defined in this function table. See Section 8.2.1 of 


the BASIC/RT-11 Language Reference Manual for instructions to add_ the 
assembly language routine definitions to the Function Table. 


NOTE 


Since only one - DEVICE programmed 
request can be active, a special routine 
SDEVHD has been added to BASIC (in the 
FTBL.MAC module) to maintain a dynamic 
device list. This routine is required 
so that abnormal termination of BASIC 
(e.g., typing CTRL/C) will return the 
system to its normal state, usually by 
disabling interrupts. 


When writing new assembly language 
routines for BASIC that would normally 
use the RT-11 -DEVICE programmed 
request, use the following code instead: 


-GLOBL SDEVHD 
MOV #LIST,RO 
JSR PC,SDEVHD 


If the .DEVICE list exceeds a block of 
30 octal words, the error message "?DSP" 
will result. The size of the block can 
be changed by defining "DSPSIZ=X" in the 
PERPAR.MAC file. 


PERVEC.MAC is the vector definition module. It defines tthe hardware 
addresses of the status registers and the interrupt vectors. The 
Standard hardware address for the LPS11 and the AR11 is 170400 (octal) 
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and interrupt vector is 340 (octal). The standard hardware address 
for the LPS11 digital I/O is LPS register+10 (octal) and interrupt 
vector is at LPS vector+l0 (octal); for the DR11-K they are at 167770 
(octal) and 300 (octal) respectively. 


There are some LPS11]1 hardware systems with the interrupt vector at 
location 300 (octal). To assemble PERVEC with the interrupt vector at 
300 (octal) it is necessary to delete the semicolon before the S$vV=0 
definition in PERPAR.MAC. If the interrupt vectors are at other 
locations then correct the interrupt addresses by using the system 
editor to define $V in PERPAR equal to the interrupt address minus 300 
(octal). For example, if the LPS11 interrupt vectors start at 320 
(octal), define $V=20 (octal). 


If the registers and interrupt vector of DRI1-K are located at 
non-Standard address, then OFFST1l and OFFST2 in PERPAR.MAC must be 
redefined. For example, if the register and interrupt vector 
addresses are at 167750 (octal) and 360 (octal), define OFFST1=-20 
(octal) and OFFST2=60 (octal). 


In a multiple DR11-K system there must be a difference of 10 (octal) 
between each unit in the interrupt and vector addresses. The status 
register address decreases by 10 (octal) while the vector address 
increases by 10 (octal). For example, in a 2 DR11-K system, when the 
first DR11-K is at 167750 and 360 (octal), the second one must be at 
167740 and 370 (octal). 


PERPAR.MAC is a parameter file, a listing follows: 

«TITLE PERPAR == PEFIPHERAL SUPPORT PACKAGE PARAMETER MODULE. 
DEC*11=-LBPAA=C BASIC KERNEL V0O2~01 

COPYRIGHT (C) 1974,1975 


DIGITAL EQUIPMENT CORPORATION 
MAYNARD, MASSACHUSETTS 01754 


THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO 

CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED 

AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION. 
DIGITAL ASSUMES NO RESPONSIBILITY FOR ANY ERRORS THAT 
MAY APPEAR IN THIS DOCUMENT 


THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A 
LICENSE FOR USE ON A SINGLE COMPUTER SYSTEM AND 

CAN BE COPIED (WITH INCLUSION OF DIGITAL'S COPYRIGHT 
NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT AS MAY 
OTHERWISE BE PROVIDED IN WRITING BY DIGITAL. 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE 
OR RELIABILITY OF ITS SOFTWARE ON EQUIPMENT 
WHICH IS NOT SUPPLIED BY DIGITAL. 


=e wa *e Ye we ~“O Ve Ye Ye VO Ye Ye Ye We WS Ve Ye “WS Ye Yeo Wo Wo YE % 


THE CONDITIONALS CONTAINED IN THIS MODULE AFFECT THE ASSEMBLY 
OF THE FUNCTION TABLE MODULE "FTBL.MAC". 

TO OBTAIN THE DESIRED CONDITIONAL DEFINITION(S), 

REMOVE (USING AN EDITOR) THE 

SEMI-COLON APPEARING BEFORE THE CONDITIONAL. 


=e Ye Ye we Ve 
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SDISK=0 


SSTRNG=0 


SRTV2=0 


® 
, 


?;DSPSIZ= 


*DEFINE 


e 
o 


7SLPS=0 
7SAR11=0 


e 
’ 


SLPS=0 


‘se Me te 


OFFST1=0 


OF FST2=0 


DEFINE 


-e we Us MS NE 


SNUMBR 


 ~e Me 


=e te te “Qe Ve te 


SADC=0 
SCLK=0 
$DIO=0 
SDIS=0 


S$DR11K= 


SNUMBR= 


0 

eIFNDF SDISK 
»ENDC 

e IFDF SDISK 
eENDC 

» IFDEF SRTV2 
GVECT=354 
CONFIG=300 

xX 

'x's 

eENDC 

e IFDF SAR1] 
eENDC 

0 

- IFDF SDR11K 
»ENDC 

"X" EQUAL 

X 

eIFNDF SNUMBR 
= i 
eENDC 

eIFDF SLPS 
eENDC 


TO REQUIRED SIZE OF 


TO TOTAL NUMBER OF DR11-K'S IN 
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;DEFINE FOR LSIe11 
*;DEFINE FOR CAPS=-11 SYSTEM 
*;DEFINE FOR RT-11 


DO NOT DEFINE FOR PTS BASIC WITHOUT 
;STRINGS,= DEFINED FOR PTS V0O1 WITH STRINGS 


s;ASSUMES RT=“11 VERSION 2 IS USED. 
7;D0 NOT DEFINE FOR RT#11 VO0115. 
; SDISK 


*;THESE ARE DISPLACEMENTS USED FOR VERSION 2 
*DISPL. TO VT1i VECTOR IN RMON 
?;DISPL. TO CONFIGURATION WORD IN RMON 


e-DEVICE LIST IN FTBL.MAC 


; SRTV2 
;DEFINE FOR LPS11 
;DEFINE FOR AR11 


;IMPLICIT DEFINITION 
7AR11 SUBSET OF LPSit1 


*;DEFINE FOR DR1i1iK 


;THE STANDARD DRii#K REGISTER IS AT 167770 
*DEFINE X, WHERE OFFST1=X, FOR NON=STANDARD 
s;CONFIGURATION. E.G. FOR REGISTER ADDRESS AT 
7167750 DEFINE X==-20, 

;THE STANDARD DR1i1i*=K VECTOR IS AT 300. 
7X, 
7E.Ge 


DEFINE 


FOR VECTOR AT 330, DEFINE X=30. 


SYSTEM 


;DEFINE FOR MULTIPLE DR1i-K SYSTEM 


DEFINE FOR LPS WITH VECTORS STARTING 
AT 300. DEFAULT SETTING IS VECTORS AT 
340. SET SV = ANY OTHER DISPLACEMENT IF 
VECTORS START AT DISPLACEMENTS 
OTHER THAN O OR 40 FROM 
VECTOR 300 


we Ye Me Vo Vs 


, INCLUDE 
; INCLUDE 
7 INCLUDE 
,; INCLUDE 
, SLPS 


A/D ROUTINES, 

CLOCK ROUTINES. 
DIGITAL IQ ROUTINES 
DISPLAY ROUTINES, 


WHERE OFFST2=X FOR NON=STANDARD CONFIGURATIO 
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DEFINE FOR PLOT SUPPORT 
NO T E==SDISK MUST ALWAYS BE DEFINED FOR 
LV11 SUPPORT. 


SPLOT=0 


=e “ese te “e “oe 
=e te tO 


e IFDF SPLOT 


$LV11=0 ; INCLUDE LV11 SUPPORT 
$VT11=0 s INCLUDE VT11 SUPPORT 
eENDC 7; SPLOT 

?SLV11=0 © ; DEFINE FOR LV11 SUPPORT 

; 

$VT11=0 7;FOR VT11 


=e te te VSO VO 


e IFDEF $VT11 


SCLOCK=0 7FOR SYSTEM CLOCK (KW11L) 
eENDC * SVT11 

; 

?SVTS5=0 *DEFINE FOR VT55 
KOT 


To link the LPS module with BASIC it is necessary to delete the 
semicolon (;) before $AR11 (for AR11 only), $LPS (for LPS only) and 
SDR1IK (for DR11-K only) statements. If any of the four optional 
modules are not to be included, a semicolon must be inserted before 
the appropriate conditional. 


Parameter Insert semicolon before parameter if: 
SADC=0 module LPS1 or ARD1 is not to be included. 
SCLK=0 module LPS2(LPS2C) or ARD2(ARD2C) is not to be 
included. 
SDIO=0 module LPS3 or ARD3 is not to be included. 
SDIS=0 module LPS4 is not to be included. 
NOTE 


If DR11-K is used on a_e system. LPSDR 
must not be used. The total number of 
DR11-K is defined in the PERPAR.MAC 
parameter file by S$NUMBR=X, where X can 
have a maximum of 16. 


Using the system assembler, the sources are assembled in the following 
combinations to produce the needed object modules: 
Object Files Source Files 


FTBL PERPAR, FTBL 
PERVEC PERPAR, PERVEC 
RTINT PERPAR,RTINT 
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After these modules have been reassembled, the LPS support can be 
linked with the BASIC object modules with only the desired optional 
LPS modules included in the LINK command strings. 


For long programs that do not use string variables, the LPS support 
may be linked with the no string object modules BASNSR, BASNSX, and 
BASNSE. This no string version of BASIC with LPS support has more 
free core for program array storage. 


After BASLPS or BASARD has been linked, it may be loaded by the 
following monitor command: 


-R BASLPS (or BASARD) 


At this point the standard BASIC initial dialogue begins. See Chapter 
1 of the BASIC/RT-11 Language Reference Manual for a description of 


the initial dialogue. 


When editing PERPAR.MAC, S$DISK=0 should be enabled for BASIC/RT-11, 
$LPS=0 should be enabled for BASIC with LPS11 support, $AR11=0 should 
be enabled for BASIC with AR11 support, and S$DR11K=0 for DR11-K 
support. SADC=0, S$CLK=0, S$DIO=0, and S$DIS=0 should be disabled 
whenever the appropriate optional LPS module (or AR11) is not to be 
included. For hardware address other than the standard, make changes 
as described in paragraph about PERVEC.MAC. 


The procedures for building the following load modules are described 
in this section: 


BASIC/RT-11 with complete LPS11 support 


BASIC/RT-11 with complete LPS11 support and LPS interrupt 
vectors at location 300 (octal). 


BASIC/RT-11 for AR11 and DR11-K (at hardware addresses 167750 
and 360 (octal)) support, with the ADC, DIO, CLK, 
and DIS optional modules. 


Linking instructions for both overlaying and non-overlaying versions 
are given for each. Since all editing instructions assume an original 
PERPAR.BAK, the edit back-up file, is renamed PERPAR.MAC to allow any 
future load modules to be built from an un-edited PERPAR.MAC. 


To build a load module BASLPS.SAV with complete configuration under 
RT-11 including LPS support and all four optional modules, enter the 
following command strings: 


LBOFMIT 

HEBPERPAR MACOS 
#Fi $1 Sk = Aa@aare} 
#F; $1 PS=A@aAngee 
+EHOD 


-& MACRO 
*ETRLSPRREAR. FTP 
ERRORS GFETFCTEM: & 

FREE CORFE: 1°67. WORDS 


HPP RVE CPE RPAR, PERE 
ERRORS GFTECTEI: A 
FREF CORF: (2439. NORMS 
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#eRTINTSPPRPAR, RT INT 
ERRORS GETECTEN: 
FREE CORE: 42568 WORDS 


OC 


ok PP 
H#RERPAR MACHPERPAR RAK OR 
HOC 


The following instructions will create a BASLPS.SAV with overlaying 
which has the maximum usable area. 


JB OLINKE 

tBASLES, BASLPOoSE 
TRANSFER ADRESS 
30 

*l Poe, L PSL, LeSe, LESS. LeSd4eC 
HRASI CR AO: Let 

HBASTOH SO: eC 

#RAST CHAO: 3 


ASICR, FPMP. FTGL. PERVEC. RTINTCE: 4aa/T HC 


4: 


To link a non-overlaying BASLPS.SAV which will have increased 
execution speed the following commands should be given to link: 


JRL INK 

HRASLES, RASLPSSRASICR, FPMP. BASICE, BASICH/E : 4naec 
HF TRL, PERVEC. RTINT AC 
#LPSO,LPSI, LESS, LPSE, LPSd, BASICH 


4: 


Complete configuration for building a load module with interrupt 
vector at location 300 (octal) - These instructions are the same as 
the preceding instructions except that a $V=0 parameter definition in 
PERPAR.MAC will be enabled. 


JR FOIT 

HE APFREAR MACOGRGS 
#F; ENT Sk = G@AArge® 
#£F; FLESCH ABAAle® 
*F; Va A@nare® 

#F B® 


LR MACRO 

HE TRLSPPRPAR, FTP. 
FREQES GETFOTFO: & 

FREE CORFE: 42858 WORGS 


HPERVECSPERPAR, PR RYE 
ERRORS GETFCTED: & 

FREF CORE: 2429 WORDS 
HRTINTSPEREAR, TINT 
ERRORS METEOTE: & 

FREE CORF: LeSAd WORKS 


# Of 
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JR PIF 
*PERPAR MACSPRRPAR BARR 
a 8 


The following procedure can create the overlaying version. 


~eE LINE 

HRASLLES, BASLESSRACTOR, FRM. PFTAL,. PERVEC, RETINTCWE: 46a/eT eo 
TRANGFFR AMGRESS = 

Gt 

HIPC, LEPOot, LPSe, LEGS. | bode 

HERASTICE AO: Ler 

HKRAS ITOH AO: LC 

tRASICHSAO: 2 


*# 


To create the non-overlaying version the following link commands 
should be given: 


JR LINE 
HRASLES, RASLESSRASTICR, FEMF. BASICE, BASICH-B : 4aa/C 
#F TAL, FERVWEC. RTINTSC 

HL PSE. LESL. LESS. L PSS. tPS4, BASICH 


A 


Partial Configuration - To build a load module BASARD.SAV under RT-11 
for AR11 and DR11-K support (at hardware address 167750 and 360 
(octal) which includes the ADC, DIO, CLK, and DIS routines, enter’ the 
following command strings: 


JF EMIT 

*#FRPERPAR MAC@E@E 
#F; ENT SK =A@aare@® 
FF; SAR LL = A@AAEeO 
#F; ERI LE = e@aAarg® 
€E MSO 


JF FIT 

+*PRPERVEC MAC@RE® 
POPP ST1=6@-C:-2o@pD 
KE OPEOTS=A®- CAA 
HENS 


JF MACRO 
*FTELSPERFAR, FTL 
FRREORS GFTECTEE: & 

FREE CORF: Le654d WORDS 


tPERYECSPERPAR, PF RYEL 
FREORS GETECTFD: & 
FREE CORF: 43423, MORES 


tRTINT=PRERPAR. ETINT 
ERRORS GFTECTER: & 
FREF CORE: 22560 WORDS 


2: 


JR FYI 


FE 
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tPPRPAR MACHPERPAR. BAK OR 
#PERVEC. MACHPRRYVEC BARR 


tRASAR OD, PASAROCSBASICR. FRPMP. PTEL, PERVEC, RTINTCE : 46@eT “ed 


#LPOa@, AROL. ARDS. ARDS, LES4 eC 


# OC: 

JR LINK 

TRANSFER ADDRESS = 
Gc 

KBASIOCE AO: 1-C 
HRASTOCR AO: LC 
tRASTOCHAC: é 

ca 


This procedure will create an overlaying version of BASLPS.SAV. 


following 


of BASIC with equivalent LPS support: 


Jk LT 


*BASARD, RASARCSRA STOR, FRMPD BASICE, BASICH AE: 4aaecr 


command 


ME 


The 


strings may be used to link a non-overlaid version 


*F TRL PRRVEC, ETINT AC 


#1 PSE, ARDL, ARGS, 


AROS. LPS4, BASICH 


The Laboratory Peripheral System support may also be purchased 


source’ fo 


rm. The 


following 


BASIC Extensions package. 


LPSO.MAC 
LPS1.MAC 
LPS2.MAC 
LPS3.MAC 
LPS4.MAC 
PTBL.MAC 
PERVEC .MAC 
RTINIT.MAC 
PERPAR. MAC 


nine 


source files are provided in 


The following table lists the assembly parameters for each module: 


Source File Conditionals 


LPSO.MAC 
LPS1.MAC 


LPS2.MAC 


LPS3.MAC 


LPS4.MAC 


None 

SAR11 
cyc50 
SAR11 
SAR11 


None 


Define for Systems with: 


AR11 hardware 


50 Hz line frequency 
(60 Hz is default) 
AR11 hardware 


AR11 hardware 


in 
the 
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Source File Conditionals Define for Systems with: 
FTBL.MAC SADC LPS1 (ARD1 for AR11) 
SCLK LPS2 (ARD2 for AR11) 
SDIO LPS3 (ARD3 for AR11) 
SDIS LPS4 
SLPS SLPSO (all systems with LPS support) 
SARI11 AR11 support 
SVT11 VT1ll support 
SDISK RT-11 
SVT55 VT55 support 
PERVEC .MAC SLPS LPS11 hardware 
SV LPS (or AR11) interrupts not at location 
340 (octal) 
SVT11 VT11 support 
SAR11 AR11 hardware 
SDR11K DR11-K hardware 
SNUMBR=X Multiple (X) DR11-K hardware 
OFFST1 First DR11-K interrupt address not at 
167770 (octal) 
OFFST2 First DR11-K vector address not at 300 
(octal) 
RTINT.MAC SDIS LPS4 


The conditional S$RTV2 is present in all modules to force subtitles in 
assembly listings and enable RT-11 V02 system macro processing. 


To assemble the LPS from the sources all the LPS files should be 
transferred to the system device using PIP, and then the following 
command should be given to the RT-11 MACRO assembler; if the line 
current is 50 Hz, the following commands should be used before calling 
MACRO: 


~R FOLT 
tEWPARAM MACE 
£TCYCSas& 


@® 

xFXO® 

.F MACRO 

HLPCASPRRPAR LESA (for LPS11 only - define SLPS in 
FRREORS GETECTED: @ PERPAR.MAC -) 


FREF CORFE: d2i44. WORDS 


#tLPOL=PERPAR, LES 
FRRORS GETFCTED: & 
FREE CORE: 11988 WORKS 


#tLPOS=PERPAR, Leos (for 60 Hz clock) 
FRECRS BETECTER: & 
FREF CORFE: 12452, WORKS 


tLPSeC=PERPAR, PARAM, Leos (for 50 Hz clock) 
ERRORS GETECTED: &@ 
FREF CORE: 42448. WORDS 


#LPSESPPREARS LESS 
ERRORS DETECTED: & 
FREF CORF: 12872. WORDS 
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tl POd=PPRPAR, LPS 
FREORS GETECTED: & 
FREE CORE: Leeed, NORE S 


HAR =PR REAR. EPS (for AR11& DR11-K only-define 
ERRORS GFTECTEM: fi SAR11& $DR11K in PERPAR.MAC) 
FREE CORE: 21988, WOR ¢ 


HARDOSaPERPAR, LESS (for 60 Hz clock) 
FRECRS GPETFCTFO: Gi 
FREE CORE: 12452. WORDS 


HARDECHPERPAR. PARFIM, LESS (for 50 Hz clock) 
FREORS GETECTED: & 
FREE CORE: 121446. MORDS 


HAR DSSPERPAR, LPoS 
ERRORS DETECTED: @ 
FREF CORP: Leaer?e, WORDS 


A 


Following is a listing of PERVEC.MAC which contains the interrupt 
vector location for the LPS and GT44 hardware: 


eTITLE PERVEC VECTOR DEFINITION MODULE FOR BASIC SUPPORT PACKAGES, 
DEC*11-LEPVA=B BASIC KERNEL VO2-01 
COPYRIGHT (C) 1974,1975 


DIGITAL EQUIPMENT CORPORATION 
MAYNARD, MASSACHUSETTS 01754 


THE INFORMATION IN THIS DOCUMENT IS SUBJECT TOQ 
CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED 
AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION, 
DEC ASSUMES NO RESPONSIBILITY FOR ANY ERRORS THAT 
MAY APPEAR IN THIS DOCUMENT. 


THIS SOFTWARE 185 FURNISHED TQ PURCHASER UNDER A 
LICENSE FOR USE ON A SINGLE COMPUTER SYSTEM AND 
CAN BE COPIED (WITH INCLUSION OF DEC'S COPYRIGHT 
NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT AS MAY 
OTHERWISE BE PRUVIDED IN WRITING RY DEC, 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE 
OR RELIABILITY OF LTS SOFTWARE ON EQUIPMENT 
WHICH LS NOT SUPPLIED BY DEC. 


~™e te Se Te TS TH Ve Te Ve Ve “Ws Te Ws Ws WH TE Ws VO We Ve Ve we te 


THIS MODULE DEFINES THE HARDWARE ADRESSES USED BY 
SUCH HARDWARE AS THE "IPS", "ARI1", "DRII-K", 

THE "VT1I1"(GT40) AND THE "LV11". 

IF THE VECTORS FORK THESE DEVICES SHOULD CHANGE 
THIS MODULE MUST BE EDITED TO REFLECT THE CHANGE, 


DEFINE SLPS FOR LPS/AR11 SUPPORT IN PERPAR 
SAR11 FOR AR11 MODS. 


we Ve Be Ve VO Yo Ve TSE WE 
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;IF SYSTEM HAS DR11*K, SNUMBR MUST BE DEFINED FQUAL TO TOTAL NUMBER 
7OF DR1It-K'S IN SYSTEM. 
DEFINE SDR11K & SNUMBR FOR DRIJ1=<K 


KK ROKK KE NOTE OK KOKA 

JTF DR1Ii-K(S) IS (CARE) PRESENT IN SYSTEM ALONG WITH THE [LPS11 
THE LPSDR CANNOT RE USED. 

FORO ROR RRO KK EE 


=e ee Se Be Ys ta We “WH 


eIFDF SLPS 

eIFNDF SV 

$V=40 

eENDC 

~GLUBL LPSAD,LPSADBKB,LPSDR,LPSDMA 

eGLOBL LPSCKS,LPSPB,LPSDRS,LPSDIB 

~-GLOBL LPSDOR,DRSTOF 

eGLOBL LPDISS, LPDISX,LPDISY 

eGLOBL CKLIVA,CKLIP,DRSIVA,DRSIP,LPSIVA,LPSIP 


? DEVICE EQUATES? 


LPSAD = 170400 3;LPS A/D STATUS REG. 
LPSADB = 170402 3:LPS A/D RUFFER LED REG, 
LPSCKS = 170404  ;LPS CLOCK STATUS REG. 
LPSPB = 170406 ;LPS CLOCK BUFFER PRESET REG, 
e LFNDF SARI11 
LPSDR = 170410 ;LPS DIGITAL J/0 STATUS REG. 
LPSDRS = LPSDR 
LPSDIB = 170412 ;LPS DIGITAL INPUT REG. 
LPSDOR = 170414 ¢LPS DIGITAL OUTPUT REG, 
LPDISS = 170416 3$3LPS DISPLAY STATUS REG, 
LPDISX = 170420 3s:LPS DISPLAY REG. X 
LPDISY = 170422 ;:LPS DISPLAY REG. Y 
eIFDF SARI1 
LPDISS = 170410 
LPDISX = 170412 
LPDISY = 170414 
eENDC 
LPSDMA = 170436 sLPS DMA REGG, 


DEFINE "“OFFSTi" IF DR11*°K NOT AT STANDARD LOCATION, ALL DR1I1=*K'S 
MUST BE NEXT TO EACH OTHERCREGISTER ADDRESS DIFFERENCE="30 ONLY) 


=e "a Ve 8 


IF DF SDRI1K 


OFFST1=0 
LPSDR = 167770+0FFST1 
LPSDRS = LPSDR 
‘LPSDIB = 167772+0OFFST1 
LPSDOR = 167774+0FF STI 
eENDC 
oIFG SNUMBR=1 
OFFST1=0 
LPSDR = 167770+0FFST1 
LPSDRS = LPSDR 
LPSDIB = 167772+OFFST1 
LPSDOR = 167774+0FFST1 
eFE NDC 
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? INTERRUPT VECTOR PAIRS? 


CKLIVA = 304+SV ADR. OF CLOCK INTERRUPT VECTOR 
CKLIP = 306+SV ;ADR. OF CLOCK INT. PRIORITY 
; 

eIFNDOF SARI1 
DRSIVA = 310+SV  ;ADR. OF DRS INPUT INT. VECTOR 
DRSIP = 312+SV ADR. OF DRS INPUT INT. PRIORITY. 


eENDC 


DEFINE “OFFST2" IF DR1i=-K NOT AT STANDARD VECTOR LOCATION, 


we “es wes 


e IFDF SDR11K 


OFFST2=0 
DRSIVA = 300+0FFST2 
DRSIP = 302+0FFST2 
~ENDC 
; 
LPSIVA = 300+$V ;ADR. OF THE A/D INT. VECTOR. 
LPSIP == 302+SV fADR. OF THE 1NT.PRIORITY. 
~-ENPC + SLPS 
~IFDF  $TABLT PROTOTYPE WRITING TABLET 
~GLUBL TSR,TINT,TVEC,XLOC,YLOC 
TSR = 164040 ;WRITING TABLET CSR 
XLOC = TSR+2 ;X LOCATION OF TURTLE 
YLOC = XLOC+2 ;Y LOCATION OF TURTLE 
TVEC = 270 ; INTERRUPT VECTOR 
~ENDC 
-IFDF $VT11  3GT40 
~GLOBL DPC,DSR,DISX,DISY,GTVECT 
DPC 7 172000 ;VT11 DISPLAY PC 
DSR = DPC+2 3VT11 DISPLAY STATUS REG 
DISX = DSR+2  ;VT11 X STATUS REG 
DISY 2 DISX+2 ;VT11 Y STATUS REG 
GTVECT = 320 7ADR. OF VT11 [GT40 (GT44)] INTERRUPT 
VECTOR LIST, REDEFINING GTVECT 
;REDEFINES THE ENTIRE SET 
;OF DISPLAY PROCESSOR INT. VECTORS, 
;GTVECT: ;DISPLAY STOP VECTOR 
;GTVECT+43 ;LIGHT PEN HIT VECTOR 
;GTVECT+10: ;DISPLAY TIME QUT VECTOR 
e-ENDC 3 SVT114 
IFDEF $LV11  ¢ LV11 SUPPORT 
~GLOBL LVCS,LVDB 
LVCS = 177514 +3 LV11 STATUS REGISTER 
LVDB = LVCS+2  ¢ LV11 DATA BUFFER 


eENDC 


THE FOLLOWING ARE GLOBAL CONSTANTS WHICH ARE REDEFINED BASED ON 
THE SYSTEM CONFIGURATION(LIKE LPS/AR11 ETC.). 


“oe te VS VWSH Ya “NS 


«-GLOBL SLP511,$8LPS12,SLPS13 7FOR LPS1 MODULE 
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SLPS113: 
o IF NDF 
«WORD 
$LPS13=6000 
eENDC 
~IFDF 
«WORD 
S$LPS13=1000 
eENDC 
e 
SLPS125 
e ITFNDF 
e WORD 
eWORD 
eENDC 
« lFDF 
«WORD 
e WORD 
eENDC 
, 
eGLOBIL 
SLPS218 
e ITFNDFE 
e WORD 
eENDC 
eTFDF 
eWORD 
eR NDC 
; 
«GLOBL 
SLPS318 
WORD 
«WORD 
eWORD 
f 
eGLOBL 
SLPS32: 177777 
177777 
’ 
eGLOBL 
e TFNDF 
$LPS41:3 .WORD 
SLPS42:3 .WORD 
$LPS43: WORD 
SLPS44:3 WORD 
eENDC 
e IFDF 
SLPS41:3 WORD 
S$LPS42: .WORD 
$SLPS433 WORD 
S$LPS443 .WORD 
eENDC 


=e “We 


eGLOBL 


DRSONS 
° WORD 
eWORD 
«WORD 
eWORD 
«WORD 
e WORD 
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SAR11 
77,4 


S$AR11 
17,2 


SAR11 
77,100 
177777,17,4 


SAR11 
17,20 
177777,2,2 
SLPS21 


SAR11 
7,17,177777 


SAR11 
7,11,377 
$LPS31 
177777 
177777 
SNUMBR#1 


SLPS32 


$LPS41,SLPS42,SLPS43,SLPS44 


SAR11 
10000 
7777 
7777 
177777 


SAR11 
2000 
1777 
1777 
177777 


DRSON,DRSTOF 


oocooccte 


7LPS 
177=63.=CHAN, 4=IGAIN 
s;FOR AUTO*GAIN RANGE CHECKING 


7 LPS 
777=63.=CHAN, 100=64.=NSC 
7177777=65535.=NPTS, 17=15.=MODE, 4=IGAIN 


;AR1I1 
717=15.=CHAN, 20=16.=NSC 
7177777=65535.=NPTS, 2=MODE, 2=IGAIN 
7FOR LPS2 MODULE 


?;LPS 
,7T=RATE, 17=15.=MODE, 177777=65535,.=PRESET 


rAR11 
7; 7=RATE, 11=9.=MODE, 377=255.=PRESET 


7FOR LPS3 MODULE 


7177777=65535.=N 
7177777365535.=MASK 
*NUMBER OF DR11-K'S IN SYSTEM, DEFAULT=1 


7177777=65535.=SW 
£177777=65535.=VARC(WRITE) 


?7FOR LPS4 MODULE 
7LPS 

710000=4096.=XMAX/YMAX 
°7777=4095.=N 

*7777=4095,=1 

7177777=65535.=NP 


;AR11 
72000=1024.=XMAX/YMAX 
71777=1023.5N 
71777=1023.=1 
7177777=65535.=NP 


*DIGITAL I/0 STORAGE VARIES WITH 
*TOTAL NUMBER OF DR1ieK'S IN SYSTEM 


sDRSONSO3 
*BCDONS 28 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 


?DRSBUF S43 DRS BUFFER DESCRIPTOR ADD. 
*DRSNPT263 DRS NUMBER OF POINTS 
PMASK3108 DRS MASK FOR INPUT 

*DRTBUF 3123 DRS TIME BUFFER DESC. 
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DRSTOF=.=*DRSON 

g 
eIFG 
«WORD 
e WORD 
«WORD 
«WORD 
«WORD 
»WORD 
eENDC 
eIFG 
e WORD 
«WORD 
e WORD 
e WORD 
eWORD 
eWORD 
eIFG 
«WORD 
» WORD 
e WORD 
«WORD 
«WORD 
«WORD 
eENDC 
eIFG 
«WORD 
WORD 
«WORD 
»WORD 
«WORD 
«WORD 
eENDC 
elFG 
e WORD 
«WORD 
eWORD 
eWORD 
»WORD 
WORD 
eENDC 
elFG 
eWORD 
WORD 
WORD 
e WORD 
«WORD 
e WORD 
eENDC 
eIFG 
eWORD 
«WORD 
WORD 
«WORD 
eWORD 
e WORD 
eENDC 
eIFG 
WORD 
ewORD 
«WORD 
»WURD 


BUILDING LOAD MODULES 


SNUMBR@~1 


occoceo 


SNUMBR"2 


ooococ 


SNUMBR=3 


ooococo 


SNUMBR“4 


oocooco 


SNUMBR#5 


ooocco 


SNUMBR=6 


ocscooco 


SNUMBR*=7 


oooco°o 


SNUMBR=10 
0 
0 


0 
0 


?DRSON: 08 
;BCDONE 28 
;DRSBUF 348 
7;DRSNPT:63 
PMASK?108 
*DRTBUF S12 


;DRSON? 03 
sBCDON:28 
;DRSBUF 343 
SDRSNPT 368 
SMASK3108 
?DRTBUF 312 


?DRSONSOS8 
;BCDONS 28 
7;DRSBUF 343 
;DRSNPT 368 
;MASK3108 
;DRTBUF 312 


;DRSON303 
;BCDON:23 
sDRSBUF 3:43 
7DRSNPT:68 
SMASK:108 
*DRTBUF 3:12 


sDRSON:03 
SBCDON: 23 
sDRSBUF 343 
SDRSNPT 368 
sMASK3103 
sDRTBUF 312 


;DRSON3 08 
*BCDONS 28 
;DRSBUF 3 438 
*PRSNPT 268 
;MASK3108 
;DRTBUF 312 


;DRSONSO8 
*BCDONE 28 
*DRSBUF 3:4: 
*DRSNPT368 
*MASK3108 
sPDRTBUF 312 


?DRSON?O3 
;BCDONS 28 
*;DRSBUF 4% 
;DRSNPT S63 
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DRS OPERATIUN IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DPS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION JN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC, 


DRS GPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DFS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DKS NUMBER OF POINTS 

DPS MASK FOR INPUT 

DRS TIME BUFFER DESC, 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 


e WORD 
«WORD 
eENDC 
e1lFG 

eWORD 
eWORD 
e WORD 
» WORD 
e WORD 
e WORD 
eENDC 
eIFG 

eWORD 
«WORD 
e WORD 
e WORD 
«WORD 
» WORD 
eENDC 
e LFG 

«WORD 
e WORD 
e WORD 
e WORD 
«WORD 
«WORD 
eENDC 
eIFG 

eWORD 
e WORD 
«WORD 
e WORD 
«WORD 
e WORD 
eENDC 
eIFG 

«WORD 
» WORD 
e WORD 
» WORD 
» WORD 
«WORD 
eENDC 
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0 
0 


SNUMBR=11 


oo co ce 


SNUMBR=12 


ooce ces 


SNUMBR=13 


ooccosd 


SNUMBR#=14 


ooccoe 


~ 
ae 


SNUMBR#15 


ooccce 


B.2 BASIC/CAPS-11 


B.2.1 


The Laboratory Peripheral System (LPS) support for BASIC is 


LPS Support 


in ten binary files. 


LPSO.OBJ 
LPS1.OBJ 


ARD1 .OBJ 


Required 
Optional 


Optional 


PMASK3108 
FDRTBUF S123 


SDRSON?O08 
sBRCDONE 2: 
s;DRSBUF 343 
SDRSNPT:63 
sMASK:103 
sDRTBUF 3:12: 


FORSONS O38 
rBCDONS 23 
*;DRSBUF 3 438 
?DRSNPT 3638 
;MASK3108 
?DRTBUF 2125 


sDRSON:O$ 
SBCDONE2: 
;DRSBUF!: 42 
SDRSNPT 2638 
sMASK3108 
;DRTBUF 312: 


sDRSON:O3 
sBCDONS 28 
s;DRSBUF:43 
sDRSNPT:63 
sMASK:108 
*DRTBUF 312: 


*DRSON?08 
*BCDON: 28 
;DRSBUF 343 
?DRSNPT 363 
*MASK3108 
7DRTBUF S123 


DRS MASK FOR INPUT 
DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BKUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD. 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADO, 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME KUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


DRS OPERATION IN PROGRESS 
BCD/BINARY SWITCH 

DRS BUFFER DESCRIPTOR ADD, 
DRS NUMBER OF POINTS 

DRS MASK FOR INPUT 

DRS TIME BUFFER DESC. 


supplied 


LPS kernel module for LPS1l or 
AR11 and DR11-K. 


Analog to digital conversion 
for LPS1ll. 
Analog to digital conversion 


for AR11 and DR11-K. 
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LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS1l. 

ARD2.OBJ Real-time clock (60 Hz line 

One is required frequency) for AR11 and 

DR11-K. 

LPS2C.OBJ Real-time clock (50 Hz line 
frequency) for LPS1l. 

ARD2C.OBJ Real-time clock (50 Hz line 
frequency) for AR11 and 
DR11-K. 

LPS3.OBJ Optional Digital input/output for 
LPS1l. 

ARD3.OBJ Optional Digital input/output for ARI11 
and DR11-K. 

LPS4.OBJ Optional Display for LPS1l or AR11 and 
DR11-K. 


The standard BASIC/CAPS binary kit contains all the object modules 
required to link a version of BASIC/CAPS that contains LPS support 
(with all four optional LPS modules). 


There are also the following files which are provided in source’ form 
in all kits: 


FTBL. PAL Function Table Module 
PERVEC. PAL Vector Definition Module 
BASINT. PAL Interface Module 
PERPAR. PAL Parameter file 

NOTE 


BASIC with LPS support requires a PDP-1l 
with 16K Or more of memory. The 
procedures in this section assume the 
user has at least 16K of memory and has 
reconfigured his CAPS-1ll system, along 
with PAL and LINK, for 16K. 


To create a version of BASIC/CAPS with complete LPS support, no GT 
Support, and a standard hardware configuration, it is only necessary 
to link the Supplied object modules. 


To create a customized version of BASIC/CAPS with LPS support, the 
parameter file PERPAR.PAL is edited and assembled with FTBL.PAL, 
PERVEC.PAL and BASINT. The three object modules produced are then 
linked with the LPS and BASIC object modules to produce a load module. 


NOTE 


All of the procedures in this section 
assume that an unaltered PERPAR.PAL is 
being edited. It is recommended that a 
copy of the original PERPAR.PAL be made 
and saved for future use. 
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The BASINT.PAL interface module should be used with all versions of 
BASIC/CAPS. If the display module is not included in the LPS support 
to be linked, another background routine may be linked with BASIC but 
it must be defined in this module. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table. FTBL.PAL is a 
function table in source form. If any user-written assembly language 
routines are also linked with BASIC the routines must be defined in 
this function table. 


PERVEC.PAL is the vector definition module. It defines the hardware 
addresses of the status registers and the interrupt vectors. The 
Standard hardware address for the LPS (or AR11) interrupt vector is 
340 (octal). In PDP-11E10 machines with LPS (or AR11) support, 
however, the interrupt vector is location 300 (octal). To assemble 
PERVEC with the interrupt vector at 300 (octal) it is necessary to 
delete the semicolon before the $V=0 definition in PERPAR.PAL. If the 
interrupt locations are at another location in memory, correct the 
interrupt addresses by using the system editor to define $V in PERPAR 
equal to the interrupt address minus 300 (octal). For example, if the 
LPS (or AR11) interrupt vectors start at 320 (octal) define SV=20 
(octal). A listing of PERVEC.PAL is printed at the end of section 
B.1.2. To link the LPS (or AR11) module with BASIC it is necessary to 


delete the semicolon (;) before the $LPS=0 (or SAR11=0) statement in 
PERPAR.PAL. If any of the four optional modules are not to be 
included, a semicolon (;) must be inserted before the appropriate 


conditional. 


Parameter Insert ; before parameter if 
SADC=0 module LPS1 or ARD1 is not to be included. 
SCLK=0 module LPS2 (LPS2C) or ARD2 (ARD2C) is not to be 
included. 
$DIO=0 module LPS3 or ARD3 is not to be included. 
SDIS=0 module LPS4 is not to be included. 


Using the system assembler PAL, the sources are assembled in the 
following combinations to produce the needed LPS object modules: 


Object File Source Files 
FTBL PERPAR, FTBL 
PERVEC PERPAR, PERVEC 
BASINT PERPAR, BASINT 


After these modules have been assembled, the LPS support may be linked 
with the BASIC object modules with only the desired optional LPS 
modules included in the LINK command strings. 


After BASLPS has been linked it may be loaded by the following monitor 
command: 


-R BASLPS 


At this point the standard BASIC initial dialogue occurs. 
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As part of the initial dialogue, BASIC prints: 
USER FNS LOADED 
This message occurs whenever BASIC has been linked with LPS support. 


When editing PERPAR.PAL, SLPS=0 should be enabled for BASIC with any 
LPS support (or $AR11 for AR11l support), and SADC=0, SCLK=0, SDIO=0, 
and S$DIS=0 should be disabled whenever the appropriate optional LPS 
module is not to be included. In addition, $V=0 should be enabled for 
any PDP-11l with LPS (or AR11) hardware interrupt located at 300 
(octal) instead of 340 (octal). Most PDP-11E10 with LPS (or AR11) 
require the defining of the $V=0 assembly parameter. For hardware 
addresses other than 300 or 340, define $V as described in paragraph 
about PERVEC.PAL. Linking BASIC/CAPS with LPS Support 


The procedures for building the following load modules are described 
below: 


BASIC/CAPS with complete LPS support. 

BASIC/CAPS with complete LPS support and _ LPS interrupt 
vectors at location 300 (octal). 

BASIC/CAPS with only the ADC and DIS_ optional display 
modules. 


Since all editing instructions assume an original PERPAR.PAL, a copy 
of the original file should be preserved to allow any future load 
modules to be built from an unedited PERPAR.PAL. 


In all the following examples the user can substitute the module LPS2C 
for the module LPS2 if the line frequency is 50 Hz instead of 60 Hz. 


Complete Configuration 


To build a load module BASLPS.SLO under CAPS-11 including LPS support 
and all four optional modules, enter the following command strings: 


(MOUNT A SCRATCH CASSETTE ON DRIVE 1) 


yar 
(TYPE <CR>) 
ae 44 
(MOUNT A SECCOND SCRATCH CASSETTE ON DRIVE 1) 
WR EDLT 
KEWL PPERPAR «LESBO 
(WHEN CASSETTE ON DRIVE 0 REWINDS, MOUNT 
CASSETEE CONTAINING PERPAR.PAL ON DRIVE 0) 
KEROSPERFAR « FAL@R@® 
KF § $CAFS=(@OAL@D 
KF §$LES=O@OAL@D 
KEX$ 4 


oR FALAS 
KOUR TRL ORJ/Pe 1 TPERPAR. LE S/F» PF TBL . PAL /F 
1? 


1? 
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FASS 2 


1? 


000000 ERRORS 


KOJPERVEC ORJ# 1° PERFAR.LES/P »ePERVEC. PAL ZF 


Le 


1? 
000000 ERRORS 


Lt 


1? 


000000 ERRORS 


x7 C : 
(Mount CAPS-1l1 system cassette on unit Q) 
(Mount scratch cassette on unit 1) 
(Mount BASIC object module cassette containing 
BASICR.OBJ 
on unit 1) 

¢R LINK 


(When unit O has rewound, mount zeroed scratch 
cassette 
on unit 0) 


KL BASLFES.SLOesLP?=O2RASTCR oy FP MPF » BASTICE » RASTCX» RASTICS/E? 4400/0 
PF TRIP ey PERVEC » RASINT » LPSO/PyLPSt o LPS 2» LPSSyLPS4» BASTICH/F 


oO? (Mount cassette with FTBL.OBJ on unit 0) 
0? (Mount cassette with LPSO.OBJ on unit 0) 
QO? (LOAD MAP PRINTED) 

FASS 2 

QO? (Mount cassette with FTBL.OBJ on unit 0) 


0 


r 


OP 


Ke 
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(Mount cassette with LPSO.OBJ on unit 0) 
(Mount cassette with BASICH.OBJ on unit 0) 


(Done. Cassette on unit 0 contains a new 
BASLPS.SLO 

which is BASIC/CAPS plus all LPS support-interrupt 
vectors 

at 340 (octal)). 


Complete Configuration 
Interrupt vectors at location 300 (octal) 


These instructions are the same as the preceding instructions 
except that a $V=0 parameter definition in PERPAR.PAL is 


enabled. 


To change the interrupt vector location, the file PERPAR.PAL 
must be edited to enable the $V=0 parameter definition. The 
new PERPAR is then used to reassemble PERVEC.PAL to 

redefine the vector locations. 


va 


oz 


oR EDIT 


> 
¢ 


+ 
¢ 


(S$) represents the ALTMODE key 
(Mount CAPS-11 system cassette on unit 0) 
(Mount scratch cassette on unit 1) 


(Mount a second scratch cassette on unit 1) 


XEWLIFERPAR . LE SOe® 


(Mount BASIC object cassette containing PERPAR. PAL 
on unit 0) 


KEROSFERFAR . PAL@ROD 
KFS SCAPS=OOAL@D 

KE 5 SLES =OQOAL@D 

KF §$V=O@OAL@D 


KE X th 


eR FALLS 


(Mount CAPS-11 system cassette on unit 0) 


KET RL /Pe 1 PERPAR. LE S/ZP oP TRL 6 PAL ZF 


(Type any keyboard character) 


(Mount cassette with FTBL.PAL on unit 1) 


(Mount second scratch cassette on unit 0) 
(Mount cassette with new PERPAR.PAL on unit 1) 


(Mount cassette with FTBL.PAL on unit 1) 


OO0000 ERRORS 


KEE VE C se 


‘i 


? 


eu 


SRERPAR. LES/Py PERVEC. FAL /F 
(Mount cassette with PERPAR.LPS on unit 1) 


(Mount cassette with PERVEC.PAL on unit 1) 
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PASS 2 
1? (Mount cassette with PERPAR.LPS on unit 1) 
Lee (Mount cassette with PERVEC.PAL on unit 1) 
(Now the cassette on unit 0 has a new PERVEC.OBJ) 
000000 ERRORS 
KXRASINT= 17 FPERFAR.LES/Fy BASINT. FAL ZF 
1? (Mount cassette with PERPAR.LPS on unit 1) 
Lt (Mount cassette with BASINT.PAL on unit 1) 
(Cassette on unit 0 now contains a new BASINT.OBJ) 
1? (Mount cassette with PERPAR.LPS on unit 1) 
1? (Cassette on unit 0 now contains a new BASINT.OBJ) 
090000 ERRORS 
KOC 


(Mount CAPS-11 system cassette on unit 0) 
(Mount cassette containing BASICR.OBJ on unit 1) 


eR LINK 
(When unit 0 hasS rewound, mount cassette with new 
PERPAR.PAL on unit 1) 


(Mount cassette with BASICR.OBJ on unit 0) 


KL2BASLES.SLOsLPY=BASTCR ey FRM » RASTCE sy RASTICX»s BASTCS/ BRE 400/0 
yFTRL/ Pe PERVEC » BASTNT so LPSO/SF ey LPST ye LES2y LP SS ey LPS4y RAST CH/F 


Oo? (Mount cassette with new FTBL.OBJ on unit 0) 
oF? (Mount cassette with LPSO.OBJ on unit 0) 
OF (Mount cassette with BASICH.OBJ on unit 0) 
ale (LOAD MAP PRINTED) 
ASG 2 
Oo? (Mount cassette with new FTBL.OBJ on unit 0) 
Q? (Mount cassette with LPSO.OBJ on unit 0) 
O? (Mount cassette with BASICH.OBJ on unit 0) 
KOC (Done. New version of BASLPS.SLO with LPS 


interrupt vectors at 300 is on cassette 1) 


Partial Configuration 


To build a load module BASLPS.SLO of BASIC/CAPS which includes’ only 
the ADC and display routines, enter the following command strings: 


(Mount CAPS-1l1l system cassette on unit 0) 
(Mount scratch cassette on unit 1) 
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02 18 
(Mount second scratch cassette on unit 1) 
Foy Za ta 


ek ELT 

KEWL IE ERP AR. LE S@® 

KEROSPERFAR . FAL@RGD 

KEROSPERFAR. FALCRGD 

KF S$ CAPS = ODOALBD 

KFS BLES = ODO ALCP 

KFS CLAN = ODOA T BD 

KF HOT = ODO A T 

KE XD ; 
(Mcunt CAPS-1l1 system cassette on unit 0) 


For AR11 support, enter the following command strings after mounting 
second scratch cassette on unit 1: 


eR FALAG 


KFT BL /P ed PERE AR. LE S/F» FT BL. PALF 
1? (Type any keyboard character) 
1? (Mount cassette with FTBL.PAL on unit 1) 


Or? (Mount Second scratch cassette on unit 0) 
Ae (Mount cassette with new PERPAR.PAL on unit 1) 
1? (Mount cassette with FTBL.PAL on unit 1) 


000000 ERRORS 
(Cassette on unit 0 now contains a new FITBLL.OBJ) 


XPERVEC SL SPERPAR, LES/FP»yPERVEC . FAL /F 
ie (Mount cassette with PERPAR.LPS on unit 1) 
1? (Mount cassette with PERVEC.PAL on unit 1) 


FASS 2 
1? (Mount cassette with PERPAR.LPS on unit 1) 
Le (Mount casset with PERVEC.PAL on unit 1) 


(Now the cassette on unit 0 has a new PERVEC.OBJ) 
000000 ERRORS 


KRASINT = TPERFPAR. LES ZF» BAS TINT. PAL “FE 
1? (Mount cassette with PERPAR.LPS on unit 1) 
1? (Mcunt cassette with BASINT.PAL on unit 1) 


(Cassette on unit 0 now contains a new BASINT.OBJ) 
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000000 ERRORS 


(Mount CAPS-11 system cassette on unit 0) (Mount 
cassette containing BASICR.OBJ on unit 1) 

eR LUNI 
(When unit 0 has rewound, mount cassette 
containing new PERPAR.PAL on unit 0) 


KIS BASLFES.SLOeLP? @BASTCR ey PE MF » BASICE » BASTICX » BASTICS/ ES 40070 


gP TRIP e PERVEC y RAS INT y LE SOE yLeSd sy LeS4» RASTCH/E 

OF (Mount cassette with new FTBL.OBJ on unit 0) 

Qi (Mount cassette with LPSO.OBJ on unit 0) 

OP (Mount cassette with BASICH.OBJ on unit 0) 

la ¥ ‘ (LOAD MAP PRINTED) 

FASS 2 

QP (Mount cassette with new FTBL.OBJ on unit 0) 

QO? (Mount cassette with LPSO.OBJ on unit 0) 

oO? (Mount cassette with BASICH.OBJ on unit 0) 

KC (Done. New version of BASLPS.SLO with only ADC 
and display routines, interrupt vectors at 340, is 

* on cassette 1) 


Assembling LPS, AR11 Support from the Sources 


The Laboratory Peripheral System support may also be purchased in 
source form. The following nine source files are provided. (The 
source files for FTBL, BASINT, PERPAR, and PERVEC are provided with 
the binary kit.) 


LPSO. PAL 
LPS1.PAL 
LPS2.PAL 
LPS3.PAL 
LPS4.PAL 
FTBL. PAL 
PERVEC. PAL 
BASINT. PAL 
PERPAR. PAL 
The following table lists the assembly parameters for each module: 


Source File Conditionals Define for Systems with: 
LPSO. PAL None 


LPS1. PAL SARK11 ARI11 hardware 
SCAPS PTS hardware 

LPS2. PAL Cyc50 50 Hz line frequency 

(60 Hz is default) 

SARI1 AR11 hardware 
SCAPS PTS hardware 

LPS3. PAL SARI1I1 AR11 hardware 

LPS4. PAL None 
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Source File Conditionals Define for Systems with: 


FTBL. PAL SADC LPS1 (ARD1 for AR11) 
SCLK LPS2 (ARD2 for AR11) 
SDIO LPS3 (ARD3 for AR11) 
SDIS LPS4 
SLPS SLPSO (all systems with LPS support) 
SAR11 AR11 support 
SVT11 VT1l1l support 
SDISK RT~11 
SVT55 VT55 support 
PERVEC. PAL SLPS LPS11 hardware 
SV LPS interrupts not at location 340 
(octal) 
SVT11 VT11l support 
SAR11 AR11 hardware 
SDRI1K DR11-K hardware 
SNUMBR=X Multiple (X) DR11-K hardware 
OFFST1 First DR11-K interrupt address not at 
167770 (octal) 
OFFST2 First DR11-K vector address not at 300 
(octal) 
BASINT. PAL SDIS LPS4 


To assemble the LPS object modules from the sources, use the following 
command strings: 


ek EGET 

SEW LT PARAM s FAaL@D 
KETC YR Oe 2 

XIE AD 

oh FALLS 


AEP SO. ORO SPERPAR.LES/PyLESO. PAL /F 


GQ? (Mount cassette with 
PERPAR.PAL on unit 0) 


OP? (Mount cassette with LPSO.PAL 
on unit 0) 


PASS: a2 


OP? (Mount cassette with 
PERPAR.PAL on unit 0) 


OF (Mount cassette with LPSO.PAL 
on unit 0) 


OOOOOO ERRORS 
KLIP SL ORI OSPERPAR. LES Py LES. PAL ZF 


Oo? (Mount cassette with 
PERPAR.PAL on unit 0) 


Oe? (Mount cassette with LPS1.PAL 
on unit 0) 
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OF (Mount cassette with 
PERPAR.PAL on unit 0) 


QO? (Mount cassette with LPS1.PAL 
on unit QO) 


OOO000 ERRORS 


KISL RS? . OBI 07 REREAR. LES/P ey LP Se. PAL ZF 

Oo? (Mount cassette with 
PERPAR.PAL on unit 0) 

OQ? (Mount cassette with LPS2.PAL 
on unit 0) 

FASS 2 

Q? (Mount cassette with 
PERPAR.PAL on unit 0) 

GQ? (Mount cassette with LPS2.PAL 


on unit 0) 
OOOd0Oo ERRORS 


For line frequency of 50 Hz, use LPS2C instead of LPS2. 


HL SLP SSC. OBIE OS PERE ARLES Ps PARAM. PAL ZF oy LPS. Fale 

OF (Mount cassette with 
PERPAR.PAL and PARAM.PAL on 
unit Q) 

Qe (Mount cassette with LPS2.PAL 


on unit QO) 


oO? (Mount cassette with 
PERPAR.PAL and PARAM.PAL on 
unit 0) 

oy (Mount cassette with LPS2.PAL 


on unit 0) 
GOGO ERE ORS 
KL SLAP SS. OR EOF RE REAR. LESZP LESS. PALF 


(ye (Mount cassette with 
PERPAR.PAL on unit 0) 


OF (Mount cassette with LPS3.PAL 
on unit 0) 


a? (Mount cassette with 
PERPAR.PAL on unit 0) 
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O? (Mount cassette with LPS3.PAL 
on unit 0) 


OO0000 ERRORS 


KI ILES4a OBIeOTPERPAR. LE S/F y LP Sa. Pal 7F 

OF (Mount cassette with 
PERPAR.PAL on unit 0) 

OT (Mount cassette with LPS4.PAL 


on unit 0) 
FASS 2 


Ov (Mount cassette with 
PERPAR.PAL on unit 0) 


Oo? (Mount cassette with LPS4.PAL 
on unit 0) 


000000 ERRORS 


For AR11 support, assemble the ARD files instead of LPS files: 


XL ART. OR UeRERP AR. ART Po LPS id. Pal Ar 

OT (Mount cassette with 
PERPAR.ARD on unit 0) 

OF (Mount cassette with LPS1.PAL 
on unit 0) 

FASS 2 


oO? (Mount cassette with 
PERPAR.ARD on unit 0) 


OF (Mount cassette with LPS1.PAL 
on unit 0) 


QOOOOO ERRORS 
ACL CARTE! OR EERE RP ALR 6 ARIZ Py LP Se BAL 


QP? (Mount cassette with 
PERPAR.ARD on unit 0) 


ge (Mount cassette with LPS2.PAL 
on unit 0) 


PASS 2 


OP (Mount cassette with 
PERPAR.ARD on unit 0) 


3 


cs 


(Mount cassette with LPS2.PAL 
on unit 0) 


GOGOOG ERRORS 
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KL ARTLC OREO PERRPAR. ARTUR y PARAM. FAL ZF ey LPS. FAL /F 


Oo? (Mount cassette with 
PERPAR.ARD- and PARAM.PAL on 
unit 0) 

OP? (Mount cassette with LPS2.PAL 


on unit 0) 


FASS 2 


Oo? (Mount cassette with 
PERPAR.ARD and PARAM.PAL on 
unit 0) 

Oo? (Mount cassette with LPS2.PAL 


on unit 0) 


GOO000 ERRORS 


KL ARTES. OR Ue PERE AR. ARTLZF y LPS. Pal Ze 

OF (Mount cassette with 
PERPAR.ARD on unit 0) 

QP (Mount cassette with LPS3.PAL 


on unit 0) 
FASS 32 


OF (Mount cassette with 
PERPAR.ARD on unit 0) 


ov (Mount cassette with LPS3.PAL 
on unit Q) 


OOO000 ERRORS 


Building a load module may now be accomplished by following the 
instructions in the preceding paragraphs. 


B.3 BASIC/PTS-11 


B.3.1 LPS Support 


The LPS support for paper tape is supplied in twelve binary tapes: 


LPSO.OBJ Required LPS kernel module for LPS11 or 
AR11 and DR11-K 

LPS1.OBJ Optional Analog to digital conversion 
for LPS11l 

ARD1.OBJ Optional Analog to digital conversion 


for AR11 and DR11-K 
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LPS2.OBJ Real-time clock (60 Hz line 
frequency) for LPS11 

ARD2.OBJ Real-time clock (60 Hz line 

One is required frequency) for AR11 and DR11-K 

LPS2C.OBJ Real-time clock (50 Hz line 
frequency) for LPS11 

ARD2C.OBJ Real-time clock (50 Hz line 
freguency) for AR11 and DR11-K 

LPS3.OBJ Optional Digital input/output for LPS1l 

ARD3.OBJ Optional Digital input/output for ARI11 
and DR11-K 

LPS4.OBJd Optional Display for LPS11 or AR11l and 
DR11-K 

PTSSTR One is Patch for BASIC with strings 

PTSNST required Patch EOL BASIC without 
Strings 


The following files are provided in source form: 


FTBL.MAC Function Table Module 
PERVEC.MAC Vector Definition Module 
PTSINT.MAC Interface Module 
PERPAR.MAC Parameter 


To build a load module BASLPS (BASIC with LPS support), the parameter 
file PERPAR.MAC is edited and then assembled with FTBL, PERVEC and the 
appropriate interface module. The six object modules produced are 
then linked with the LPS and BASIC object modules to produce a load 
module. The specific instructions that are given to the system 
programs (editor, assembler, and linker) are given in the examples 
that follow the general description of load module building. 


The two patch tapes, PTSSTR and PTSNST, alter one location in BASICL 
to permit the LPS scope to be refreshed by a background routine, a 
routine that is active while BASIC waits for input. A patch tape 
should only be used with BASIC/PTS VOl. The Patch tape used should be 
linked after the last LPS tape. PTSNST should be linked when  BASICL 
without strings is linked and PTSSTR should be linked when BASICL with 
strings is linked. 


NOTE 


All of the procedures in this’ section 
assume that an unaltered PERPAR is being 
edited. It is recommended that a copy 
of the original PERPAR be made and saved 
for future use. 


The BASINT interface module should be used with all versions of BASIC 
except BASIC/PTS V0Ol which should have PTSINT used in the place of 
BASINT. 


For the LPS routines to be accessible from the BASIC CALL statement, 
the routine must be defined in a System Function Table. FTBL.MAC is a 
function table in source form. If any user-written assembly language 
routines are also linked with BASIC the routines must be defined in 
this function table. 


PERVEC is the vector definition module. It defines the hardware 
addresses of the status registers and the interrupt vectors. The 
standard hardware address for the LPS interrupt vector is 340 (octal). 
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In PDP-11E10 machines with LPS support, however, the interrrupt vector 
is location 300 (octal). To assemble PERVEC with the interrupt vector 
at 300 (octal) it is necessary to delete the semicolon before the $V=0 
definition in PERPAR.MAC. If the interrupt locations are at another 
location in memory then correct the interrupt addresses by using the 
system editor to define $V in PERPAR equal to the interrupt address 
minus 300 (octal). For example, if the LPS interrupt vectors start at 
320 (octal) define $V=20 (octal). 


To link the LPS module with BASIC, it is necessary to delete the 
semicolons (;) before the SLPS=0 statement. If any of the four 
optional modules are not to be included, a semicolon (;) must be 
inserted before the appropriate conditional. 


Parameter Insert ; before parameter if 

SADC=0 module LPS1 or AR11 is not to be included. 

SCLK=0 module LPS2 (LPS2C) or AR11 is not to be included. 
$DIO=0 module LPS3 or AR11 is not to be included. 

SDIS=0 module LPS4 or AR11 is not to be included. 
SSTRNG=0 no string version of BASICL is to be linked. 


Using the system assembler, the sources are assembled in the following 
combinations to produce the needed LPS object modules: 


Object File Source Files 
FTBL PERPAR,FTBL 
PERVEC PERPAR, PERVEC 
BASINT or PERPAR, BASINT 
PTSINT PERPAR, PTSINT 


After these modules have been assembled, the LPS support may be linked 
with the BASIC object modules with only the desired optional LPS 
modules included in the LINK command strings. 


Example Load Buildings 


Examples are given for building a load module for the following three 
systems: 


1. BASIC with strings, with complete LPS (or AR11) Support, and 
with the LPS (or. ARI11) interrupt vectors located at 340 
(octal). 


2. BASIC without strings with complete LPS (or AR11) support and 
with the LPS (or AR11) interrupt vectors located at 300 
(octal). 


3. BASIC with strings, with a partial LPS (or AR11) 
configuration (one that includes the ADC, DIS, and CLK but 
does not include the DIO), and with the LPS (or ARI11) 
interrupt vectors located at 340 (octal). 
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To build a load module called BASLPS.LDA, the following instructions 
should be followed: 


Load ED-11 (the PDP-11 Paper Tape Software Text Editor) which is’ used 
to edit a source paper tape, PERPAR, which describes the required 
options. Place the supplied PERPAR.MAC in the high speed paper tape 
reader then follow one of these three procedures: 


l. For a load module of BASIC including strings with Support for 
a complete configuration of the LPS (all four optional 
modules) and with the LPS interrupt vectors at location 340 
(octal), the following instructions should be given to the 
editor: 


*T H 

*Ct H 

aR 

#H 

i €CAPS=4 
i $CAPS=4 
GA 

* Os 

*H 

i LPS=e 
; €LPSo=6 
+A 


(Ct 


At this point, the punch has the edited PERPAR. 

2. Or for a load module of BASIC with no strings, with support 
for a complete configuration of the LPS and with the LPS 
vectors located at 300 (octal), the following instructions 
should be given to the editor: 


*T H 

*C H 

+k 

sod | 

i $CAPS=@ 
3 €CAPS=6 
* A 


*D 


B-31 


BUILDING LOAD MODULES 


+4 
$C TRNG= 
FS TRNG= 
+ GA 


*T 


3 


*H 
i; $€LPS=& 
i €LPS=@ 
* AF 


*D 


*H 
; $¥=6 
i $¥=Q 
*BA 


At this point the punch has the edited PERPAR. 


Or to build a load module 
configuration of the LPS, 
CLK but excludes the DIO 
(octal), the following 
editor: 


*T H 

*C H 

+: Fe 

#H 

i €CAPS=6 
i €CAFS=A 
BA 

* ( 

+H 

i $LFosh 
i $LFS=6 
+A 

* [3 

*H 


O01 O=4@ 
#C0TO=@ 


of BASIC with strings for a partial 
one that includes the ADC, DIS, and 
with the LPS interrupts at 340 
instructions should be given the 
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At thi 


Load PAL-11S. 
tapes. 
high-speed read 
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s point, the punch has the edited PERPAR. 


It is used to generate FTBL, PERVEC, and PTSINT object 


When PAL-11 has been loaded, put the edited PERPAR tape in the 


er and answer the following questions. 


PAL-115S 

*S 4H 

*B dH 

*L P 

*T Pp 

The PERPAR tape is now read. 

EOF? When EOF? is printed, remove the PERPAR tape and put 
the FTBL source tape in the high-speed reader. Then 
type catriage return. 

END? When END? is printed, remove the FTBL source tape. and 
insert the PERPAR tape in the high-speed reader. When 
ready, type a carriage return. 

EOF? When EOF? is printed, remove the PERPAR tape and 
replace it with the FTBL source tape. (Note that both 
tapes are loaded twice in the assembly process.) 

000000 ERRORS 

PAL-118S 

*S When *S is printed, the new FTBL object tape is in the 
high-speed punch and may be removed. It is this tape 
(called FTBL) that will be used in the linking process 
to generate a new load module. 

PAL-11S 


These steps are 
produce a PERV 


then repeated using the PERPAR and PERVEC tapes to 
EC object tape and then repeated again using the PERPAR 


and PTSINT tapes to produce a 


PTSINT object tape. 


Building the load module iS accomplished by 
bottom address specified should be 400. 


using 


Link the object tapes in the following order. 


BASICL.OBJ 


The 
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FPMP.OBJ 

PTSINT.OBJ 

PERVEC.OBJ 

FTBL.OBJ 

LPSO.OBJ 

LPS1.OBJ or ARD1.OBJ 

LPS2.O0BJ or ARD2.OBJ (for 60 Hz line frequency) 
LPS2C.OBJ or ARD2C.OBJ (for 50 Hz line frequency) 
LPS3.OBJ or ARD3.OBJ 

LPS4.0BJ 

PTSNST 

BASICH.OBJ 


If SSTRNG was left unchanged when editing PERPAR, BASICL with strings 
must be used. If a semicolon was inserted before SSTRNG, BASICL for 
no string must be used. 


Exclude the optional files for which a semicolon was inserted before 
the appropriate conditional in PERPAR. In the example given for a 
configuration not including the DIO, do not include LPS3.O0BJ in the 
linking process. 


To assemble the LPS from the sources the following procedure should be 
followed: 


Load PAL-11S. It is used to generate LPSO, LPS1, LPS2, LPS3, and LPS4 
binary tapes. Put the LPSO source tape in the high speed reader. 
Enter the following commands 


PAL-118S 

*S 4H 

*B H 

*T, PB 

*T Pp The tape is now read. 

END? Re-insert the tape in the reader, press <CR> 
000000 

PAL-11S 

*S 


Repeat this procedure for the LPS1, LPS2(LPS2C), LPS3, and LPS4 Source 
tapes or if the line frequency is 50 Hz, LPS2 should be assembled by 
the following procedure (LPSO, LPS1,LPS3, and LPS4 are still assembled 
as described above). Load ED-ll (the PDP-1l Paper Tape Software 
Editor) with the absolute loader, then create a parameter tape as 
follows: 


*I H 
ball © ie «| 
aT 


CYC50=0 
-EOT 
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Load the PAL-11S assembler and insert the tape created by the above 
commands. Follow this procedure: 


PAL~118 


*S 4H 
*B 4H 
*L Pp 
mi - <P 
EOF? 
END? 


EOF? 
000000 


PAL-118 
*S 


Insert the LPS2 source tape and press <CR>. 
Insert the tape created by the editor and press 


<CR>. 


Insert the LPS2 source tape and press <CR>. 


At this point the LPS2 binary tape is in the 


high-speed punch. 


The following table lists the assembly parameters for each module: 


Source File 
LPSO.MAC 


LPS1.MAC 


LPS2.MAC 


LPS3.MAC 
LPS4.MAC 


VT55.MAC 
Source File 


FTBL.MAC 


PERVEC.MAC 


Conditionals 


None 


SAR11 
SCAPS 


CYC50 


SARI11 
SCAPS 


SARIi1 
None 


VT55 
Conditionals 


SADC 
SCLK 
$DIO 
$DIS 
SLPS 


$vT11 
SDISK 
$VT55 


SLPS 

SV 

SvT1l 
SAR11 
SDR11K 
SNUMBR=X 


OFFST1 


OFFST2 


B=35 


Define for Systems with: 


AR11 hardware 
PTS hardware 


50Hz line frequency (60 
Hz is default) 

AR11 hardware 

PTS hardware 


AR11 hardware 


vT55 terminal 
Define for Systems with: 


LPS1l 

LPS2 

LPS3 

LPS4 

SLPSO (all systems with 
LPS support) 

VT11 support 

RT-11 

VT55 support 


LPS1ll hardware 

LPS interrupts not at 
location 340 (octal) 

VT11 support 

AR11 hardware 

DR11-K hardware 

Multiple (X) DR11-K 
hardware 

First DR11-K interrupt 
address not at 167770 
(octal) 

First DR11-K vector 


PTSINT.MAC 
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address not at 300 
(octal) 


$DIS LPS4 


To include AR11, simply define SAR11 in addition to $CAPS symbols in 


PERPAR Source tape. 


B-36 


APPENDIX C 


ERROR MESSAGES 


This appendix summarizes the error messages that may occur when’ using 
BASIC Extensions call routines. See Appendix P of the RT-1ll System 
Reference Manual for all error messages that may occur under the RT-11 
system. 


?ADC ERROR AT LINE XXXXX 
BASIC Ext Fatal Cannot issue ADC command while an RTS 
operation is underway. 


?ARG ERROR AT LINE XXXXX 
BASIC Fatal Arguments in a function call do not match 
(in number or in type) the argument defined 
for the function. 


?BUF ERROR AT LINE XXXXX 
BASIC Ext Fatal Buffer name given in LPS command has not 
been previously defined in a USE statement. 


?DEV ERR-C 
BASIC Ext Non--fatal The device specified is illegal. 


?DSP ERROR AT LINE XXXXxX 


BASIC Ext Fatal -DEVICE list space overflow. Redefine 
DSPSIZ in PERPAR.MAC and reassemble 
FTBL.MAC. 
?DVO ERROR AT LINE XXXXX 
BASIC Fatal Program attempted to divide some quantity 
by 0. 


?NOR ERROR AT LINE XXXXX 
BASIC Ext Fatal Number out of range. 


?SYN ERROR AT LINE XXXXX 
BASIC Fatal The program has encountered an 
unrecognizable statement. Common syntax 
errors are mispelled commands and unmatched 
parentheses, and other typographical 
errors. 


?UNF ERROR FUNCTION AT LINE XXXXX 
BASIC Fatal The function called was not defined by the 
program or was not loaded with BASIC. 


Term 


Analog 


Auto-gain 


Bipolar 


Buffer 


Clock 


DMA 


Gain 


Global 


Initialize 


Library 
Routine 


Mass Storage 


Overflow 


Parameter 


GLOSSARY 


Definition 


Numbers represented by directly measurable 
(as voltages, resistances, or rotations). 


guantities 


Software determination of the best switch gain value to 
use sampling analog data using the LPSAM-SG option. 


Refers to a Signal that is either positive or negative 
with respect to system ground. 
A temporary storage area which may be ae_e special 


register or an area of storage. 


A time-keeping or frequency-measuring device within the 
computer system. 


Direct Memory Access. The DMA is attached to any 
PDP-11 allowing memory data storage or retrieval at 
memory cycle speeds without processor intervention. 

ratio of 


An increase in signal power. Gain in the 


output power to input power. 

A value defined in one program module and used in 
others. Globals are often referred to as "entry 
points" in the module in which they are defined and 
"aexternals" in the other modules which use them. 

To set counters, Switches, addresses and variables’ to 
zero or other starting values. 


A collection of standard routines 
incorporated into larger programs. 


which can be 


Pertaining to a device such as a disk or DECtape which 
stores large amounts of data readily accessible to the 
central processing unit. 


A condition that occurs when a mathematical 
yields a result whose magnitude 
program is capable of handling. 


operation 
is larger than the 


A variable or an arbitrary constant appearing in a 
mathematical expression, each value of which restricts 
or determines the specific form of the expression. 


Glossary-1 


Preamplifier 


Source file 


GLOSSARY 


An electronic circuit or device that detects) and 
sufficiently amplifies weak signals. 


A file to be used as input to a translating program 
such as MACRO or BASIC. 


Glossary-2 


INDEX 


A/D Conversion, 2-7 DRS, 2-2, 2-19 
ACC, 2-2, 2-5 DXY, 2-3, 2-25 
ADC, 2-1, 2-2, 2-7 

Array, 2-3 


Auto-gain, 2-7 
Flashing data, 2-26 
FSH, 2-3, 2-25 
FXY, 2-3, 2-26 
Background Display Routine, 2-23 , 


Buffer, 
defining the display, 2-22 
display, 2-25 Hardware, 2-27 
putting data into display, HIST, 2-2, 2-16 
2-23 Histograms, 2-15 


ring, 2~6, 2-8, 2-15 
Burst Mode, 2-10 


Internal clock, 2-16 
Interrupt Mode, 2-13 


Channel, 2-8 IPK, 2-2, 2-21 
Clock, 2-1, 2-10 
Clock, 
internal, 2-16 
Clock Mode, 2-14 LED, 2-1, 2-2, 2-11 
CLRD, 2-2, 2-22 Light Emitting Diodes, 2-11 
Control, LPSO, 2-3 
relay, 2-21 LPS1, 2-7 
Conversion, LPS2, 2-12 
A/D, 2-7 LPS3, 2-17 
CVSG, 2-2, 2-12 LPS4, 2-22 
LPSAD~-12, 2-1 
LPSAD-NP, 2-1 
LPSAG, 2-1, 2-8 
DACS, 2-2 LPSAG-VG, 2-1 
Data, LPSAM, 2-1 
flashing, 2-26 LPSDR, 2-2 
returning, 2-6 LPSKW, 2-2, 2-13 
Data from memory, LPSSH, 2-1 
reading, 2-21 LPSVC, 2-2 


Data into display buffer, 
putting, 2-23 
Data into memory, 


writing, 2-21 Memory , 
Data overrun, 2-6 reading data from, 2-21 
Defining the display buffer, 2-22 writing data into, 2-21 
Digital readout, 2-19 Mode, 
DIM, 2-3 Burst, 2-10 
DIR, 2-2, 2-17 Clock, 2-14 
DIS, 2-3, 2-23 Interrupt, 2-13 


Display buffer, 2-25 
defining the, 2-22 
putting data into, 2-23 

Display routine, Numeric readouts, 2-7 
background, 2-23 

DMA, 2-1, 2-11 

DOR, 2=2, 2-19 


Index~-1 


INDEX (Cont.) 


Overflow, 2-16 
Overrun, 
data, 2-6 


PUTD, 2-2, 2-23 
Putting data into display 
buffer, 2-23 


RDB, 2-2, 2-6 
Reading data from memory, 2-21 
Readout, 

digital, 2-19 
Readouts, 

numeric, 2-7 
Real-time sampling, 2-7, 2-8 
REL, 2-2, 2-21 
Relay control, 2-21 
Retrigger, 2-17 
Returning data, 2-6 
Ring buffer, 2-6, 2-8, 2-15 
Routine, 

background display, 2-23 
RTIM, 2-2, 2-16 
RTS, 2=2 


Sampling, 

real-time, 2-7, 2-8 
Schmitt Trigger, 2-1, 2-10 
Schmitt Trigger, 

timed, 2-15 
SETC, 2-2, 2-14 
SETR, 2-2, 2-12, 2-13 
Subscript, 2-3 
SVSG, 2-12 


Target variable, 2-6, 2-7, 2-17 
Timed Schmitt Trigger, 2-15 


USE, 2-2, 2-3 


Variable, 
target, 2-6, 2-7, 2-17 


WAIT, 2-2, 2-16 
Writing data into memory, 2-21 


Index-2 


ine. 


this 


Please cut along 


Please indicate 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repcrt (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


SE ee 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


the type of user/reader that you most nearly represent. 


Assembly language programmer 

Higher-level language programmer 

Occasional programmer (experienced) 

User with little programming experience 

Student programmer 

Non-programmer interested in computer concepts and capabilities 


Name a Date 
Organization tac eee 
Street Fn 
City ees SRBC 8 I Code 
ox 
Country 


If you require a written reply, please check here. {J 
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